codex-ultragoal

Codex plugin scaffold for durable repo-native multi-goal orchestration with embedded success criteria and observable evidence audit.

Behavior

Subcommand	Purpose
`omo ultragoal create-goals`	Create repo-native goals from a brief and seed criteria.
`omo ultragoal record-evidence`	Record observable evidence for the active criterion.
`omo ultragoal criteria`	Inspect or revise goal success criteria.
`omo ultragoal complete-goals`	Complete eligible goals after criteria pass.
`omo ultragoal checkpoint`	Refuse completion until criteria and evidence gates pass.
`omo ultragoal steer`	Apply steering updates to the plan.
`omo ultragoal status`	Report active goal, criteria, and evidence state.

Wave 1 is scaffold only. Command behavior lands in later waves.

Codex Plugin

The plugin ships:

.codex-plugin/plugin.json for Codex plugin discovery.
hooks/hooks.json for the UserPromptSubmit hook.
skills/ultragoal/ as the future skill directory.

The hook command is:

node "${PLUGIN_ROOT}/dist/cli.js" hook user-prompt-submit

No MCP server or Codex tool is exposed in this scaffold.

Local Development

npm install
npm test
npm run typecheck
npm run check
npm pack --dry-run

Local Codex Installation

From the marketplace root containing this plugin:

codex plugin marketplace add /path/to/codex-plugins
node /path/to/codex-plugins/scripts/install-local.mjs /path/to/codex-plugins

If your local Codex build exposes plugin install commands, you can install from the UI or CLI instead. For older local builds, the marketplace installer builds and copies the plugin into ~/.codex/plugins/cache/<marketplace>/omo/0.1.0, installs runtime dependencies there, and enables:

[features]
plugins = true
plugin_hooks = true

[plugins."omo@code-yeongyu-codex-plugins"]
enabled = true

Privacy

This plugin runs locally. The scaffold does not call a network service by itself.

License

MIT.

oh-my-codex - source project for the ultragoal port.
codex-plugins - local Codex plugin marketplace.

2.4 KiB Raw Blame History