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. /clearCmd. /renameCmd. /archiveCmd. /deleteCmd. /compactCmd. /copyCmd. /memoriesCmd. /importCmd. /initCmd. /mentionCmd. /forkCmd. /sideCmd. /resumeCmd. /newCmd. /cdCmd. /exportCmd. /recap

Planning and execution

Cmd. /planCmd. /goalCmd. /psCmd. /stopCmd. /app

Review and verification

Cmd. /review

Models and settings

Cmd. /modelCmd. /fast

Permissions and integrations

Cmd. /permissionsCmd. /ideCmd. /setup-default-sandboxCmd. /sandbox-add-read-dirCmd. /pluginsCmd. /hooksCmd. /approveCmd. /skillsCmd. /mcp

Status and diagnostics

Cmd. /agentCmd. /appsCmd. /diffCmd. /feedbackCmd. /personalityCmd. /rawCmd. /statusCmd. /debug-configCmd. /title

Display and input

Cmd. /keymapCmd. /vimCmd. /experimentalCmd. /statuslineCmd. /themeCmd. /petsCmd. /voiceCmd. /worktree

Account and usage

Cmd. /exitCmd. /logoutCmd. /quitCmd. /usage

Legacy

Cmd. /approvals

Verification and history

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

Cmd. /worktree

Run new or forked sessions in isolated Git checkouts

Key takeaways

  • Run new or forked sessions in isolated Git checkouts
  • Check the input surface and availability before using the examples below.

Purpose

Run new or forked sessions in isolated Git checkouts

/worktree

Availability

FieldValue
Input surfaceRunning CLI prompt
KindBuilt-in
StatusExperimental
Aliases—
Documented minimumNot specified
Reviewed against2026-09-22 · Codex CLI 0.155.1
Release evidencev0.154.0

Experimental feature evidenced in 0.154.0. Requires a Git repository and supported build; the CLI also offers --worktree.

Examples

/experimental
/worktree

/worktree and CLI --worktree provide experimental worktree sessions. Start new work or a fork in a separate checkout, then browse and resume that session.

codex --worktree

Check the branch and checkout path when entering isolated work. In 0.155.0 the agents view shows worktree ownership and asks for confirmation before deleting clean managed worktrees. Archiving a conversation and deleting its worktree are separate operations.

See thread lifecycle for the wider workflow.

Effects and persistence

Starts or forks work in a separate Git worktree. Check the new checkout's path and branch.

Cautions

Experimental feature evidenced in 0.154.0. Requires a Git repository and supported build; the CLI also offers --worktree.

Official sources

  • Changelog
  • Developer Commands

Complete command list · Verification scope · History for this command

Related docs

Multi-session Workflow

Claude Code Complete Guide · Run parallel Claude Code sessions with git worktrees and agent view without losing branch, context, or verification control.

Cmd. /batch

Claude Code Command Master · Parallelize a large change across worktree subagents (skill).

Cmd. /experimental

Toggle experimental Codex features from the TUI.

Cmd. /diff

Review current Git changes from inside Codex.

Cmd. /run-skill-generator

Claude Code Command Master · Generate project-specific /run and /verify skills.

Cmd. /voice

Experimental voice conversations and live transcripts on supported builds

Cmd. /exit

Exit the Codex CLI session; equivalent to /quit.

On this page

PurposeAvailabilityExamplesEffects and persistenceCautionsOfficial sources