Skip to content

houmao-mgr agents single/self turn

Managed headless turn submission and inspection commands.

houmao-mgr agents single --agent-id <id> turn [OPTIONS] COMMAND [ARGS]...
houmao-mgr agents single --agent-name <name> turn [OPTIONS] COMMAND [ARGS]...
houmao-mgr agents self turn [OPTIONS] COMMAND [ARGS]...

These commands target server-managed native headless agents for durable turn submission and post-turn inspection.

agents single ... turn uses the group-level selected-agent target. agents self turn targets the current registered managed tmux session and accepts no explicit selector or --port.

Commands

submit

Submit one managed headless turn for a headless agent.

houmao-mgr agents single --agent-id <id> turn submit [OPTIONS]
Option Description
--prompt TEXT Prompt text to submit. If omitted, piped stdin is used.
--model TEXT Request-scoped headless execution model override for this turn only.
--reasoning-level INTEGER Optional tool/model-specific reasoning preset index override for this turn only.
--port INTEGER Houmao pair authority port to use.

The override flags affect only the submitted turn. They do not rewrite the stored manifest or future turns for the managed headless agent. Partial overrides are supported: supplying --reasoning-level without --model merges with the launch-resolved model defaults through the shared headless resolution helper rather than resetting fields that were not explicitly overridden. The meaning of --reasoning-level depends on the resolved tool/model ladder, higher unused numbers saturate to that ladder's highest maintained Houmao preset, and 0 means explicit off only when that ladder supports it. Because scoped turn submit targets managed headless routes directly, TUI-target rejection does not apply here, but the same overrides are rejected clearly when reached through scoped prompt or gateway prompt for a TUI-backed target.

status

Show one managed headless turn status payload.

houmao-mgr agents single --agent-id <id> turn status [OPTIONS] TURN_ID
Argument Description
TURN_ID Identifier of the turn to inspect.
Option Description
--port INTEGER Houmao pair authority port to use.

events

Replay canonical managed headless turn events for one managed headless turn.

houmao-mgr agents single --agent-id <id> turn events [OPTIONS] TURN_ID

This command replays Houmao's canonical semantic event stream for the turn instead of dumping raw provider stdout. It honors the root --print-plain, --print-json, and --print-fancy selection and defaults to plain + concise.

Use --detail detail when you need provider provenance and raw canonical event context. Use stdout or stderr when you need the exact durable provider artifacts.

Argument Description
TURN_ID Identifier of the turn to inspect.
Option Description
--port INTEGER Houmao pair authority port to use.
--detail [concise\|detail] Canonical replay detail level. concise renders the stable answer/action/completion summary; detail includes extra structured provenance.

stdout

Print the raw persisted stdout artifact for one managed headless turn.

houmao-mgr agents single --agent-id <id> turn stdout [OPTIONS] TURN_ID
Argument Description
TURN_ID Identifier of the turn to inspect.
Option Description
--port INTEGER Houmao pair authority port to use.

This route stays raw on purpose. It returns the provider-owned stdout artifact and does not substitute canonical semantic JSON or replayed human rendering.

stderr

Print the raw persisted stderr artifact for one managed headless turn.

houmao-mgr agents single --agent-id <id> turn stderr [OPTIONS] TURN_ID
Argument Description
TURN_ID Identifier of the turn to inspect.
Option Description
--port INTEGER Houmao pair authority port to use.

Like stdout, this command remains a raw durable-artifact inspection surface rather than a canonical event renderer.

See Also