Cmd. /goal
Set, inspect, pause, resume, or clear an experimental long-running task goal.
Key takeaways
/goalattaches an experimental persistent objective to the active thread and requiresfeatures.goals(available from Codex 0.128.0).- A goal should describe outcome and stopping criteria, not every execution step, for example
/goal Finish the migration and keep tests green. - Run
/goalafter resuming a long task to confirm the objective still matches, and/goal clearwhen scope changes. - It is experimental, so treat pause/resume behavior as version-sensitive.
Original Command Declaration
/goalOfficial Summary
/goal attaches an experimental persistent objective to the active thread. It requires
features.goals.
Usage
/goalGood Examples
- Use
/goal Finish the migration and keep tests greento state both outcome and verification. - Run
/goalafter resuming a long task to confirm the objective still matches. - Use
/goal clearwhen the scope changes.
Similar Commands
| Command | Difference | Choose It When |
|---|---|---|
/goal | Persists an objective | Work spans many turns or interruptions |
/plan | Produces an implementation plan | You need steps before starting |
/status | Shows session state | You need policy, model, or token state |
Use Cases
- Long migrations.
- Repeated verification loops.
- Multi-day bug hunts or performance tuning.
Recent Changes
- Goals are available starting in Codex 0.128.0.
- Newer releases made goals more discoverable and clearer around pause/resume behavior.
Cautions
/goalis experimental.- A goal should describe outcome and stopping criteria, not every execution step.
Release Basis
- Judgment: confirmed addition
- First evidence version:
rust-v0.128.0 - Date (UTC): 2026-04-30
- Release link: https://developers.openai.com/codex/changelog
Sources
- Codex slash commands: https://developers.openai.com/codex/cli/slash-commands
- Codex changelog: https://developers.openai.com/codex/changelog