Cmd. /app
Hand off the current CLI thread to Codex Desktop.
Key takeaways
- Hand off the current CLI thread to Codex Desktop.
- Check the input surface and availability before using the examples below.
Purpose
Hand off the current CLI thread to Codex Desktop.
/appAvailability
| Field | Value |
|---|---|
| Input surface | Running CLI prompt |
| Kind | Built-in |
| Status | Conditional |
| Aliases | — |
| Documented minimum | Not specified |
| Reviewed against | 2026-09-22 · Codex CLI 0.155.1 |
Session handoff is available for supported macOS and Windows apps.
Examples
/appWhen to use it
- Start investigation in the CLI, then continue in the desktop app for review and thread management.
- On Windows, hand a workspace into native Codex Desktop instead of stopping at a manual launch prompt.
Choosing related commands
| Command | Difference | Choose It When |
|---|---|---|
/app | Hands off the current CLI thread | You want to continue the same task in Codex Desktop |
/apps | Browses connectors and inserts $app-slug mentions | You need an app connector in the prompt |
codex app | Starts the desktop app from the shell | You are opening a project path outside an active slash-command flow |
Effects and persistence
Hands the current session to a supported Codex app.
/app is an officially documented command for handing the current CLI thread into Codex Desktop. Use it when a task started in the terminal needs the desktop app's review, diff, terminal, thread, or worktree surfaces.
Changes
/appcan hand off the current CLI thread into Codex Desktop on macOS and native Windows.- Windows workspace launches can open directly into Desktop instead of stopping at a manual prompt.
- The command was first release-tracked in the 0.138.0 changelog and was confirmed in the official slash-command table on 2026-08-03.
Cautions
- Do not confuse
/appwith/apps:/appswitches interface, while/appsinserts connector mentions. - Handoff behavior depends on local app installation, OS support, workspace trust, and sign-in state.
- After handoff, re-check
/status,/permissions, and/diffbefore high-risk edits.
Official sources
Complete command list · Verification scope · History for this command