| name | ultragoal |
| description | Create and execute durable repo-native multi-goal plans over Codex goal mode artifacts. |
Ultragoal Workflow
Use when the user asks for ultragoal, create-goals, complete-goals, durable multi-goal planning, or sequential execution over Codex /goal.
Purpose
ultragoal turns a brief into repo-native artifacts and then drives one goal at a time through Codex goal tools:
.omx/ultragoal/brief.md
.omx/ultragoal/goals.json
.omx/ultragoal/ledger.jsonl
Create goals
- Run one of:
omx ultragoal create-goals --brief "<brief>"
omx ultragoal create-goals --brief-file <path>
cat <brief> | omx ultragoal create-goals --from-stdin
- Inspect
.omx/ultragoal/goals.json and refine if needed.
Complete goals
Loop until omx ultragoal status reports all goals complete:
- Run
omx ultragoal complete-goals.
- Read the printed handoff.
- Call
get_goal.
- If no active Codex goal exists, call
create_goal with the printed payload.
- Complete that single goal only.
- Run a completion audit against the objective and real artifacts/tests.
- When complete, call
update_goal({status: "complete"}).
- Checkpoint the durable ledger:
omx ultragoal checkpoint --goal-id <id> --status complete --evidence "<evidence>"
- If blocked or failed, checkpoint failure:
omx ultragoal checkpoint --goal-id <id> --status failed --evidence "<blocker/evidence>"
- Resume failed goals with
omx ultragoal complete-goals --retry-failed.
Constraints
- The shell command cannot directly invoke Codex interactive
/goal; it emits a model-facing handoff for the active Codex agent.
- Never call
create_goal when get_goal reports a different active goal.
- Never call
update_goal unless the current goal is actually complete.
- Treat
ledger.jsonl as the durable audit trail; checkpoint after every success or failure.