Skip to main content
Glama

launch_subagent

Launch a coding CLI subagent in a detached tmux window, specifying prompt, model, working directory, and agent in a single call.

Instructions

Launch a coding-CLI subagent in a detached tmux window.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
cliNoCLI to launch: claude or opencodeclaude
cwdNoWorking directory for the subagent
taskNoShort human label for the window name
agentNoAgent argument passed to the CLI
modelNoModel argument passed to the CLI
promptNoTask prompt for the subagent
windowNotmux window name; defaults to task or prompt slug
dry_runNoReturn the generated wrapper without launching
sessionNotmux session name; defaults to basename(cwd)
dangerousNoSkip permission prompts (--dangerously-skip-permissions / --auto)
extra_argsNoAdditional CLI arguments (list preferred)
prompt_fileNoPath to a prompt file (fallback if prompt not provided)
prompt_modeNo'inline' feeds the prompt on argv; 'pointer' feeds a bootstrap read-the-file promptinline
settle_secondsNoSeconds to wait before capturing initial output

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultYes
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already indicate readOnlyHint=false and openWorldHint=true, so the description adds 'detached tmux window' as extra behavioral context. However, it does not disclose important traits like the default dangerous=true (skip permission prompts) or that it generates and runs a wrapper script. It provides some value but lacks deeper behavioral nuance.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, front-loaded sentence with no wasted words. It efficiently communicates the core action and environment context, earning a top score for conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (14 parameters) and the presence of a full input schema and output schema, the one-line description provides a sufficient high-level understanding. It could be slightly more complete by noting the background execution or permission implications, but overall it is adequate for a schema-rich tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3 even though the description itself does not mention any parameters. The description adds no additional meaning beyond what the parameter descriptions already provide.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Launch') and resource ('coding-CLI subagent') with a distinguishing detail ('detached tmux window'). It clearly differentiates from sibling tools (check, list, send, stop) by indicating creation/startup rather than inspection or messaging.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no explicit guidance on when to use this tool versus alternatives. While the name and first word imply starting a new subagent, there is no mention of use cases, prerequisites, or exclusions, and it does not reference the sibling tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/garland3/subagent-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server