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. /goal
한국어English

Cmd. /goal

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

Key takeaways

  • Set, inspect, pause, resume, or clear a persistent long-running task goal.
  • Check the input surface and availability before using the examples below.

Purpose

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

/goal

Availability

FieldValue
Input surfaceRunning CLI prompt
KindBuilt-in
StatusCurrent reference
Aliases—
Documented minimumNot specified
Reviewed against2026-09-22 · Codex CLI 0.155.1

features.goals is currently stable and enabled by default; user or organization configuration can disable it.

Examples

/goal Finish the migration and keep the tests green
/goal
/goal edit
/goal pause
/goal resume
/goal clear

When to use it

  1. Use /goal Finish the migration and keep tests green to state both outcome and verification.
  2. Run /goal after resuming a long task to confirm the objective still matches.
  3. Use /goal clear when the scope changes.

Choosing related commands

CommandDifferenceChoose It When
/goalPersists an objectiveWork spans many turns or interruptions
/planProduces an implementation planYou need steps before starting
/statusShows session stateYou need policy, model, or token state

Effects and persistence

Attaches an objective to the thread across turns. Update or clear it when the task scope changes.

/goal attaches a persistent objective to the active thread. The features.goals setting is stable and enabled by default; enabling an experimental toggle is no longer a prerequisite.

Cautions

Objective text must be non-empty and at most 4,000 characters. Reference a file for longer instructions. On v0.151.0+, nested-subagent token usage also counts toward the root goal budget.

  • Check whether user or organization configuration has disabled goals.
  • A goal should describe outcome and stopping criteria, not every execution step.

Official sources

  • Developer Commands
  • Changelog
  • Config Reference

Complete command list · Verification scope · History for this command

Related docs

Cmd. /goal

Claude Code Command Master · Persist work until a completion condition is met.

Cmd. /workflows

Claude Code Command Master · Watch, pause, resume, or save dynamic workflows.

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.

Cmd. /plan

Switch to plan mode and optionally send a planning prompt.

Cmd. /plan

Switch to plan mode and optionally send a planning prompt.

Cmd. /ps

Show background terminals and recent output.

On this page

PurposeAvailabilityExamplesWhen to use itChoosing related commandsEffects and persistenceCautionsOfficial sources