Skip to main content
reopt Handbook
reopt Handbook
Codex Command MasterLabels and command selectionHow to read a detail guideComplete command listTerminal CLI Commands and Options

Task guides

Core Command GroupSession Command GroupCustom Command GuideMCP Command and Integration GuideDesign Workflows

Conversation and context

Cmd. /archiveCmd. /copyCmd. /importCmd. /cd

Planning and execution

Cmd. /goalCmd. /app

Models and settings

Cmd. /model

Permissions and integrations

Cmd. /pluginsCmd. /hooksCmd. /mcp

Display and input

Cmd. /statuslineCmd. /tuiCmd. /worktreeCmd. /voice

Account and usage

Cmd. /usage

Verification and history

Current verification scopeHandbook updatesRelease coverage historyEarlier verification recordsCommand change history
Handbook›Codex Command Master›Cmd. /app
한국어KOEnglishEN

Cmd. /app

Continue the current CLI session in the ChatGPT desktop app on macOS and Windows.

Written and reviewed by Eric Han · Co-founder & CTO, reopt

Key takeaways

  • Continue the current CLI session in the ChatGPT desktop app on macOS and Windows.
  • Unlike /apps, which inserts connector mentions, /app hands the same conversation to the desktop app UI; it errors if the app is not installed or running.

Purpose

Continue the current CLI session in the ChatGPT desktop app on macOS and Windows.

/app

Availability

FieldValue
Input surfaceRunning CLI prompt
KindBuilt-in
StatusConditional
Aliases—
Documented minimumNot specified
Reviewed against2026-10-23 · Codex CLI 0.163.0

Session handoff is available for supported macOS and Windows apps.

Examples

/app

When to use it

  1. Start investigation in the CLI, then continue in the desktop app for review and thread management.
  2. On Windows, hand a workspace into native Codex Desktop instead of stopping at a manual launch prompt.

Choosing related commands

CommandDifferenceChoose It When
/appHands off the current CLI threadYou want to continue the same task in Codex Desktop
/appsBrowses connectors and inserts $app-slug mentionsYou need an app connector in the prompt
codex appStarts the desktop app from the shellYou 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

  • /app can 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 /app with /apps: /app switches interface, while /apps inserts connector mentions.
  • The official page names the target as the ChatGPT desktop app on macOS and Windows. If the app isn't installed or running, Codex shows an error asking you to install or launch it.
  • Handoff behavior depends on local app installation, OS support, workspace trust, and sign-in state.
  • From 0.157.0, a conversation open in another app can be forked with the f shortcut, keeping drafts and queued prompts.
  • After handoff, re-check /status, /permissions, and /diff before high-risk edits.

Official sources

  • Developer Commands
  • Changelog

Complete command list · Verification scope · History for this command

Related docs

Cmd. /desktop

Claude Code Command Master · Continue the session in Claude Code Desktop (/app).

Codex App and IDE

Advanced Codex Usage · Use Codex across the app, terminal, and IDE without losing context discipline.

Terminal CLI Commands and Options

All 29 official Codex CLI command entries, global and command-specific option tables, and release additions

Cmd. /run

Claude Code Command Master · Launch and drive the app to verify a change (skill).

Cmd. /verify

Claude Code Command Master · Build, run, and observe the app to verify a change (skill).

Cmd. /goal

Set, inspect, pause, resume, or clear a persistent long-running task goal.

Cmd. /model

Switch among GPT-6 Astra, GPT-6.1 Sol, and GPT-6 Luna, the earlier GPT-6 Sol and GPT-5.6 models, and supported reasoning effort levels.

On this page

PurposeAvailabilityExamplesWhen to use itChoosing related commandsEffects and persistenceChangesCautionsOfficial sources