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

Cmd. /goal

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

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

Key takeaways

  • Set, inspect, pause, resume, or clear a persistent long-running task goal.
  • Write the outcome and stopping rule in under 4,000 characters, and manage progress with /goal pause, resume, and clear.

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-10-23 · Codex CLI 0.163.0

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. /resume

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

Cmd. /workflows

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

Cmd. /rename

Claude Code Command Master · Changes the current session's name while retaining its conversation.

Session Command Group

Commands for keeping long Codex sessions continuous and readable.

Cmd. /cd

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

Cmd. /app

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

On this page

PurposeAvailabilityExamplesWhen to use itChoosing related commandsEffects and persistenceCautionsOfficial sources