DevSpace subagents

Use the DevSpace CLI through the shell or process tool. Run commands from the project the subagent should work on.

Choose a target

Discover usable targets instead of guessing names:

devspace agents targets --json

Configured profiles include a description and may define provider, model, effort, and task instructions. Choose a matching profile when one fits. Use a provider target when no profile fits or a specific provider is needed.

Usually rely on the target's configured model and effort. Pass --model or --effort only with a value supported by that provider. DevSpace passes these values through without translating them between providers.

Start work

Give the subagent a self-contained brief. Include the objective, relevant paths, constraints, decisions it needs from the current conversation, and the expected result. The subagent receives the brief and its profile instructions, not the parent conversation.

devspace agents run <profile-or-provider> "<brief>" --json
devspace agents run <profile-or-provider> --model <model> --effort <effort> "<brief>" --json

The result contains a DevSpace agent id and its current status. Execution continues independently, so retain the ID for later inspection or follow-up.

Inspect and continue

devspace agents show <id> --json
devspace agents continue <id> "<follow-up brief>" --json
devspace agents ls --json

• show waits briefly for active work, then returns the current status and any

available response or error.

• continue gives the same subagent another turn with its existing provider

session and context.

• ls returns sessions belonging to the current project.

Run devspace agents show <id> --json again later while the status is running. completed includes the response. failed includes a structured error, and stopped is terminal without a successful response. Continue an agent when its existing context is useful; start another agent for unrelated work.

Good uses

• Review a change for correctness, security, or missing tests.
• Investigate a bounded part of a codebase and report findings.
• Implement one isolated change with clear acceptance criteria.
• Run a focused verification pass after other work.