#/goal

1 messages · Page 1 of 1 (latest)

sturdy jasper
#

How can I use /goal in an empty repo?

glossy sorrelBOT
#

Hi @sturdy jasper. I'm kapa.ai, your friendly support bot. I will try to answer your question by searching through the knowledge base. :wave:

#

/goal is an experimental Codex CLI slash command that attaches a persistent objective to the current thread. It doesn’t depend on your repo contents, so you can use it even in an empty Git repo, as long as the feature is enabled.

From the docs:

  1. Enable goals (once):

    • Open the experimental features menu with /experimental and turn on goals, or
    • Add this to your config.toml under [features]:
      [features]
goals = true

    [Control session]

  2. Set a goal in your (empty) repo:

    • Start Codex in that repo (it must still be a Git repo for normal safety checks). [Git required]
    • In the chat, run:
      /goal Describe and scaffold the initial structure for this new project
    • This attaches the text as the goal for the current thread. [Control session]

  3. Inspect or manage the goal:

    • View current goal:
      /goal
    • Pause, resume, or clear:
      /goal pause
/goal resume
/goal clear

    [Control session]

The docs don’t mention any extra limitations specific to empty repositories beyond the usual “must be a Git repo” requirement.

Note: you can ask me a follow up question by @ mentioning me again :speech_balloon: