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. /cd
한국어KOEnglishEN

Cmd. /cd

Track the 0.149.0 working-directory commands and verify their live behavior in the installed slash-command help.

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

Key takeaways

  • Track the 0.149.0 working-directory commands and verify their live behavior in the installed slash-command help.
  • /cd, /pwd, and /cwd were added in 0.149.0 and are listed in the reference reviewed on 2026-10-23. /cd changes an idle primary chat’s directory; use absolute paths when needed.

Purpose

Track the 0.149.0 working-directory commands and verify their live behavior in the installed slash-command help.

/cd <path>

Availability

FieldValue
Input surfaceRunning CLI prompt
KindBuilt-in
StatusCurrent reference
Aliases—
Documented minimumNot specified
Reviewed against2026-10-23 · Codex CLI 0.163.0
Release evidencev0.150.0

This entry is absent from the current command table or tracked separately through releases. Check the evidence and installed build.

Examples

/cd ../shared

When to use it

  1. Inspect /cd in the installed slash picker before moving a live monorepo task.
  2. Inspect /pwd and /cwd separately and record the reported cwd before resuming or queueing work.

Choosing related commands

CommandDifferenceChoose It When
/cd <path>Changes the active directoryThe same task must move to another work root
/pwd, /cwdRelease-note companions; exact relationship is not yet specified in the referenceYou need to inspect the live build's directory context
/new [name]Starts a new taskBoth directory and conversation context should split

Effects and persistence

Changes the session's working directory. From 0.160.0, moving to a folder without a saved trust decision asks for folder trust and offers "Keep current directory" to cancel. Check the resulting path and project settings.

The 0.149.0 release note says /cd, /pwd, and /cwd manage the working directory. It does not document each command's exact syntax, output, or alias relationship, and the current Developer Commands reference has not caught up. In a 0.149.0+ build, open the slash-command picker and follow its inline signature before moving a live task.

Cautions

  • Prefer an absolute path when ambiguity matters; the current reference does not publish relative-path resolution details.
  • Moving directories does not bypass trust or managed deny-read policy.
  • From 0.160.0, moving to a folder without a saved trust decision asks for folder trust; choosing "Keep current directory" cancels the move. Codex rechecks running tasks and background terminals before switching and enforces the destination's permission requirements.
  • On 0.151.0+, regression tests should confirm the same deny-read and writable-root boundaries before and after /cd.
  • A new project's AGENTS.md becomes an instruction source only after the project is trusted.
  • Do not automate against a presumed /pwd or /cwd output format until the reference documents it.

Documentation status

This page intentionally separates release evidence from reference evidence. The 0.149.0 changelog confirms the command group; the current Developer Commands inventory does not yet list these three entries. The installed slash picker is therefore the final source for build-specific behavior.

Official sources

  • Changelog
  • Developer Commands
  • Rust V0.160.0

Complete command list · Verification scope · History for this command

Related docs

Cmd. /add-dir

Claude Code Command Master · Add a working directory for file access in this session.

Cmd. /resume

Claude Code Command Master · Resume by ID, name, or picker (/continue).

Session Command Group

Commands for keeping long Codex sessions continuous and readable.

Slash Commands

Advanced Codex Usage · Use Codex slash commands as an operating surface for sessions, review, models, and status.

Complete command list

Every Codex CLI slash command on one page: syntax, kind, and availability for all 57 official rows, plus examples, effects, and cautions by category.

Cmd. /import

Import Claude Code or Cursor setup, project files, and recent chats into Codex.

Cmd. /goal

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

On this page

PurposeAvailabilityExamplesWhen to use itChoosing related commandsEffects and persistenceCautionsOfficial sources