Cmd. /agent
Switch between spawned Codex subagent threads to inspect each agent transcript, status, model, and reasoning effort before merging their work.
Key takeaways
- Switch between spawned Codex subagent threads to inspect each agent transcript, status, model, and reasoning effort before merging their work.
- Check the input surface and availability before using the examples below.
Purpose
Switch between spawned Codex subagent threads to inspect each agent transcript, status, model, and reasoning effort before merging their work.
/agentAvailability
| Field | Value |
|---|---|
| Input surface | Running CLI prompt |
| Kind | Built-in |
| Status | Current reference |
| Aliases | /subagents |
| Documented minimum | Not specified |
| Reviewed against | 2026-09-22 · Codex CLI 0.155.1 |
The installed command menu and account or organization settings determine availability.
Examples
/agentWhen to use it
- After spawning a subagent, use
/agentto inspect the subagent transcript and current status. - In long multi-agent work, combine
/agent,/status, and/diffbefore deciding what to integrate.
Choosing related commands
| Command | Difference | Choose It When |
|---|---|---|
/agent | Switches among spawned agent threads | You need to inspect an agent's work |
/side | Opens a temporary side conversation | You need a short separate question |
/fork | Branches the current conversation | You need a longer alternate path |
Effects and persistence
Switches the visible thread and conversation target to the selected agent.
/agent (/subagents) switches the active thread so you can inspect or continue work in a spawned subagent.
Session cleanup in 0.155.0
The agents overview supports task hiding, archiving, and deletion, worktree ownership details, and confirmed deletion of clean managed worktrees. Distinguish these lifecycle actions from /agent thread switching.
Cautions
- Do not treat subagent output as merged work until you review diffs and tests.
- Use
/statusif you are unsure which thread is active.
Official sources
Complete command list · Verification scope · History for this command