subagent#

usage: openprogram subagent [-h] verb ...

`subagent spawn`#

Spawn an agent in the given session as a new branch.

Option	Description
`--session` `SESSION`	Session id to spawn into (the new branch / root lives here)
`--prompt` `PROMPT`	Prompt the spawned agent receives as its only user turn
`--parent-msg` `PARENT_MSG`	Specific node id to fork off in inherit mode (defaults to the session's current HEAD)
`--label` `LABEL`	1-3 word label used as the branch name
`--agent` `AGENT`	Agent profile id to run the spawn under (default: main)
`--context` `CONTEXT`	inherit (default): forks off the parent turn, inheriting the conversation chain. clean: new root in the same session, the agent sees only the prompt.
`--clean`	Shortcut for --context clean
`--no-json`	Print human-readable summary instead of JSON

Merge N subagent sessions into the target with a new turn.

Option	Description
`--target` `TARGET`	Target session id (gets the merge reply + multi-parent commit)
`--branch` `SID`	Subagent session id to include in the merge (repeat for multiple)
`--message` `MESSAGE`	Merge instruction (the merge agent reads this alongside each branch's final text)
`--agent` `AGENT`	Agent profile to run the merge under (default: main)
`--base` `N`	0-based index into --branch list. Marks that branch as the merge BASE — the reply is written as a continuation of it, with the others as supplemental context (attach-style merge).
`--no-json`	Print human-readable summary instead of JSON

List resource views for tasks in a session.

Option	Description
`--session` `SESSION`	Session id whose tasks should be listed
`--json`	Print the canonical task resource views as JSON

Show one task's resource view.

Option	Description
`task_id`	Task id to inspect
`--json`	Print the canonical task resource view as JSON

Cancel one task and show its updated resource view.

Option	Description
`task_id`	Task id to cancel
`--json`	Print the canonical task resource view as JSON