Codex macOS app should natively support `/goal` like Codex CLI

Resolved 💬 6 comments Opened May 10, 2026 by coygeek Closed May 22, 2026
💡 Likely answer: A maintainer (github-actions[bot], contributor) responded on this thread — see the highlighted reply below.

Summary

Codex CLI already supports the experimental /goal feature for long-running tasks, but the Codex macOS app does not appear to expose, recognize, or provide feedback for it.

In the CLI, /goal can set/view/pause/resume/clear a durable objective attached to the active thread. In the macOS app, typing /goal into the composer shows No commands, and there is no visible goal state, goal status feedback, or equivalent UI affordance.

This creates a cross-surface mismatch: a long-running Codex workflow can be goal-driven in the CLI, but the same concept is invisible or unavailable in the native macOS app.

Why this matters

The official Codex docs describe /goal as a way to give Codex a durable objective for long-running work with a clear stopping condition and validation loop.

This is especially useful for:

  • multi-phase implementation work
  • plan execution
  • long CI repair loops
  • refactors/migrations
  • eval or prompt optimization loops
  • work that may be interrupted, compacted, or resumed later

The macOS app is exactly the kind of surface where users benefit from explicit state and feedback. Without native goal support, the app gives no indication that goals exist, whether one is active, or how to inspect/control one.

Current behavior

Codex CLI

Using Codex CLI, /goal is available and works natively.

Example CLI behavior:

› /goal

/goal  set or view the goal for a long-running task

When a goal is active, the CLI reports it in-session, for example:

Goal active Objective: $execute-plans

The CLI session can also be resumed later with the goal context still meaningful.

Codex macOS app

In the macOS app, typing /goal into the composer does not expose a slash command.

Observed behavior:

No commands

There is also no visible goal indicator in the composer, thread header, status area, command palette, or progress UI.

Expected behavior

The macOS Codex app should support /goal as a first-class feature with behavior matching the CLI as closely as possible.

At minimum:

  1. Typing /goal in the macOS app should be recognized as a command, not treated as ordinary prompt text.
  2. The app should support the same basic goal operations as CLI:
  • /goal <objective> to set a goal
  • /goal to view the active goal
  • /goal pause
  • /goal resume
  • /goal clear
  1. If goals are behind features.goals, the app should either:
  • expose the same experimental feature toggle, or
  • clearly explain that goals must be enabled in config before use.
  1. When a goal is active, the app should show visible state somewhere durable, such as:
  • thread header
  • status/sidebar area
  • compact active-goal banner
  • model/settings/status popover
  1. During a goal-driven run, the app should provide feedback aligned with the CLI contract:
  • current goal objective
  • checkpoint/progress state where available
  • paused/running/complete status
  • clear blocked/error state if the goal cannot continue
  1. If the macOS app cannot yet support goals, it should display an explicit unsupported-command message instead of No commands.

Suggested UX

A minimal implementation could be:

  • Add /goal to the app slash-command menu.
  • Add an active goal indicator near the model/status controls.
  • Clicking the indicator opens a small panel:
Goal
Status: Active

Objective:
<goal text>

Actions:
Pause | Resume | Clear

A stronger implementation could also show checkpoint-style progress summaries, since the official guidance emphasizes compact progress reports for long-running goal work.

Reproduction steps

  1. Enable goals for Codex CLI:
[features]
goals = true
  1. Start Codex CLI.
  2. Run:
/goal Complete a long-running task until final verification passes.
  1. Confirm CLI accepts and reports the goal.
  2. Open the Codex macOS app.
  3. Type:
/goal
  1. Observe that the app composer/command surface reports:
No commands

Actual result

The macOS app does not show /goal as an available command and does not provide any native goal UI or status feedback.

Expected result

The macOS app should support goal creation, inspection, pause/resume/clear controls, and visible active-goal state with parity to Codex CLI behavior.

Environment

  • Codex CLI version observed: 0.130.0
  • Codex CLI model/session shown: gpt-5.5 high
  • Platform: macOS
  • Codex surface affected: native macOS Codex app
  • CLI feature: experimental /goal enabled via features.goals

References

Official docs:

  • Codex CLI slash commands: /goal is documented as “Set or view an experimental goal for a long-running task” and supports set/view/pause/resume/clear.

https://developers.openai.com/codex/cli/slash-commands#set-an-experimental-goal-with-goal

  • Codex “Follow a goal” use case: goals are described as durable objectives for long-running work with a verifiable stopping condition.

https://developers.openai.com/codex/use-cases/follow-goals

Related GitHub repo:

Impact

This is not just a missing shortcut. /goal changes the operating contract of a long-running Codex thread. If the CLI supports that contract but the macOS app does not expose it, users lose visibility and control when switching between Codex surfaces.

Native macOS app support would make goal-driven work more trustworthy, especially for long autonomous tasks where users need durable state, pause/resume controls, and clear progress feedback.

View original on GitHub ↗

6 Comments

github-actions[bot] contributor · 2 months ago

Potential duplicates detected. Please review them and close your issue if it is a duplicate.

  • #21125

Powered by Codex Action

etraut-openai contributor · 2 months ago

Yes, this will be coming to the app soon!

abracadabra50 · 2 months ago

fyi: you can enable in app by asked codex to enable the feature flag.

samuelkahessay · 2 months ago

Update from the macOS app side: goal support appears to exist now, or at least partially exists.

I was able to trigger goal functionality from the Codex macOS app via natural language, not CLI.

Prompt used:

Do you know the /goal command in codex? Use that to complete the plan

After that, the Mac app showed a native Goal card with active status and goal controls. I’m not attaching the screenshot because it contains personal project details, but the UI included:

  • Goal title/header
  • Active status
  • elapsed time
  • edit / pause / delete / expand controls

So this may not be “goals are unsupported in the macOS app.” It looks more like the underlying goal capability is present, but /goal slash-command discoverability/parity is missing or unclear.

The remaining gap I’d suggest tracking is:

  • /goal does not appear to be discoverable as a Mac app slash command.
  • It is unclear what natural-language triggers create a goal.
  • It is unclear whether goal support is gated by app version, rollout, or config.
  • The docs/issue should distinguish “native goal UI exists” from “CLI-style /goal command parity exists.”
a692570 · 2 months ago

Adding another data point from Codex desktop on macOS.

Current behavior observed:

  • User typed /goal in this desktop chat expecting the new goal behavior mentioned publicly.
  • It did not start a goal, spawn anything, or show a clear unsupported-command path.
  • Local CLI is codex-cli 0.125.0.
  • codex features list on this install does not include goals at all, so codex features enable goals is not available until upgrading CLI.
  • ~/.codex/config.toml has a [features] section enabled for other features, but no goals flag.

Why this still feels like an app issue:

  • Public docs and X make /goal look like a current Codex feature.
  • The desktop app does not explain whether goals are CLI-only, require a newer CLI, require features.goals, or are behind a staged app rollout.
  • A natural-language prompt may create a Goal card in some builds, based on the comment above, but the trigger and rollout are not discoverable enough for users to know what is wrong.
  • There is also confusion between “follow a goal” and “spawn agents.” It would help if the app clarified that /goal is a persistent goal loop, not a subagent spawning command.

Expected behavior:

If /goal is not available in the desktop app, the app should say so directly and point to the required version or feature flag. If natural-language goal creation is the intended desktop UX, it should be visible in the command/menu surface and documented.

coygeek · 2 months ago

This is implemented today.

Update to Version 26.519.22136 (3003)