# Ultragoal

Create and execute durable repo-native multi-goal plans over Codex goal mode artifacts.

- Repository: https://github.com/Yeachan-Heo/oh-my-codex (33693 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Yeachan-Heo/oh-my-codex --skill ultragoal -g -a claude-code -y`
Codex: `npx skills add Yeachan-Heo/oh-my-codex --skill ultragoal -g -a codex -y`
Cursor: `npx skills add Yeachan-Heo/oh-my-codex --skill ultragoal -g -a cursor -y`
Gemini CLI: `npx skills add Yeachan-Heo/oh-my-codex --skill ultragoal -g -a gemini-cli -y`

## Description

Create and execute durable repo-native multi-goal plans over Codex goal mode artifacts.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Ultragoal Workflow

## When to use

Use for `ultragoal`, `create-goals`, `complete-goals`, durable multi-goal planning, or sequential execution over Codex `/goal`. Read `AGENTS.md#durable-runtime-invariants-canonical-ssot` for state ownership and goal-tool boundaries.

## Inputs and preconditions

- Durable artifacts are `.omx/ultragoal/brief.md`, `.omx/ultragoal/goals.json`, and `.omx/ultragoal/ledger.jsonl`.
- New plans use aggregate Codex goal mode by default: one stable pointer objective for the plan while OMX tracks individual stories. Use `--codex-goal-mode per-story` only when explicitly requested.
- Do not call `/goal clear` from shell or this skill. After a completed run, the operator may clear the interactive Codex goal in the Codex UI before another same-thread run.

## Operational steps: create

Run one command, then inspect the generated plan:
```bash
omx ultragoal create-goals --brief "<brief>"
omx ultragoal create-goals --brief-file <path>
cat <brief> | omx ultragoal create-goals --from-stdin
omx ultragoal create-goals --codex-goal-mode per-story --brief "<brief>"
```
If refinement is needed, use explicit supported steering rather than editing durable artifacts by hand.

## Operational steps: execute

Repeat until `omx ultragoal status` reports all goals complete:

The rest: https://github.com/Yeachan-Heo/oh-my-codex/blob/HEAD/plugins/oh-my-codex/skills/ultragoal/SKILL.md