22
33Multi-runtime plugin suite + autonomous coding factory for the Ultra Builder Pro
44agent engineering system. It ships native plugins for ** Claude Code · OpenCode ·
5- Codex** , retains a compatibility adapter for Gemini CLI, and orchestrates PRD →
5+ Codex** and orchestrates PRD →
66dependency graph → parallel session execution → auto-merge with a single
77authoritative ` .ultra/state.db ` .
88
99<div align =" center " >
1010
11- [ ![ Version] ( https://img.shields.io/badge/version-0.5.3 -blue )] ( ./CHANGELOG.md )
11+ [ ![ Version] ( https://img.shields.io/badge/version-0.6.0 -blue )] ( ./CHANGELOG.md )
1212[ ![ Tests] ( https://img.shields.io/badge/tests-passing-brightgreen )] ( #verification )
1313[ ![ License: MIT] ( https://img.shields.io/badge/license-MIT-green )] ( ./LICENSE )
1414[ ![ Node] ( https://img.shields.io/badge/node-%E2%89%A522-informational )] ( ./package.json )
@@ -23,7 +23,7 @@ authoritative `.ultra/state.db`.
2323
2424- ** Builds host-native plugins from one allowlist.** Claude Code, OpenCode, and
2525 Codex receive their own command/skill, agent, hook, and MCP representation.
26- Gemini remains a compatibility adapter; uninstall is symmetric .
26+ Install and uninstall are symmetric on every supported host .
2727- ** Shares state across runtimes.** ` .ultra/state.db ` (SQLite + WAL) is the
2828 authoritative source for tasks, sessions, events, and telemetry. ` tasks.json `
2929 and context markdown are generated projections, not handwritten.
@@ -43,7 +43,6 @@ authoritative `.ultra/state.db`.
4343npx ultra-builder-pro-cli --claude --local
4444npx ultra-builder-pro-cli --opencode --local
4545npx ultra-builder-pro-cli --codex --local
46- npx ultra-builder-pro-cli --gemini --local
4746
4847# Or blanket-install to every supported runtime you have
4948npx ultra-builder-pro-cli --all --local
@@ -59,8 +58,7 @@ After install, start a new host session/task and point it at the project.
5958Claude Code and OpenCode expose native command forms. Codex exposes the same workflows as namespaced plugin
6059skills such as ` $ultra-builder-pro:ultra-init ` , ` $ultra-builder-pro:ultra-plan ` ,
6160and ` $ultra-builder-pro:ultra-dev ` ; ` command-map.json ` records the nine legacy
62- command mappings (` ultra-review ` remains a directly invocable skill). Gemini
63- retains its compatibility command form.
61+ command mappings (` ultra-review ` remains a directly invocable skill).
6462See [ ` docs/RUNTIME-COMPAT-MATRIX.md ` ] ( ./docs/RUNTIME-COMPAT-MATRIX.md )
6563for per-runtime capabilities.
6664
@@ -85,15 +83,15 @@ deployment, skill-discovery, and framework guidance belong to their original plu
8583
8684## Runtime capability matrix
8785
88- | Feature | Claude Code | OpenCode | Codex CLI | Gemini CLI |
89- | ------------------------------| :-----------:| :--------:| :---------:| :----------: |
90- | Custom commands | ✅ | ✅ | ✅ | ✅ |
91- | Skill loader | ✅ | ✅ | ✅ (personal plugin) | ✅ |
92- | MCP server (stdio) | ✅ | ✅ | ✅ (plugin ` .mcp.json ` ) | ✅ |
93- | Workflow hooks | ✅ (native plugin) | ✅ (native JS plugin) | ✅ (native plugin) | ⚠︎ compatibility only |
94- | Sub-agents | ✅ | ✅ | ✅ (9 native TOML agents) | ⚠︎ |
95- | Session worktree isolation | ✅ (all runtimes; driven by ` orchestrator/session-runner.cjs ` ) | ✅ | ✅ | ✅ |
96- | Parallel dispatch + auto-merge | ✅ (` ubp-orchestrator run ` ) | ✅ | ✅ | ✅ |
86+ | Feature | Claude Code | OpenCode | Codex CLI |
87+ | ------------------------------| :-----------:| :--------:| :---------:|
88+ | Custom commands | ✅ | ✅ | ✅ |
89+ | Skill loader | ✅ | ✅ | ✅ (personal plugin) |
90+ | MCP server (stdio) | ✅ | ✅ | ✅ (plugin ` .mcp.json ` ) |
91+ | Workflow hooks | ✅ (native plugin) | ✅ (native JS plugin) | ✅ (native plugin) |
92+ | Sub-agents | ✅ | ✅ | ✅ (9 native TOML agents) |
93+ | Session worktree isolation | ✅ (driven by ` orchestrator/session-runner.cjs ` ) | ✅ | ✅ |
94+ | Parallel dispatch + auto-merge | ✅ (` ubp-orchestrator run ` ) | ✅ | ✅ |
9795
9896Full details in [ ` docs/RUNTIME-COMPAT-MATRIX.md ` ] ( ./docs/RUNTIME-COMPAT-MATRIX.md )
9997(10 sections, with per-runtime deviations called out).
@@ -124,7 +122,7 @@ Or let the skills drive it. In Codex, invoke
124122
125123| Binary | Purpose |
126124| --------| ---------|
127- | ` ultra-builder-pro-cli ` / ` ubp ` | Installer — ` --claude / --opencode / --codex / --gemini / -- all ` , ` --local / --global ` , ` --uninstall ` , ` --skip-rtk ` |
125+ | ` ultra-builder-pro-cli ` / ` ubp ` | Installer — ` --claude / --opencode / --codex / --all ` , ` --local / --global ` , ` --uninstall ` , ` --skip-rtk ` |
128126| ` ubp-orchestrator ` | Session dispatch daemon — ` run ` , ` start ` , ` stop ` , ` status ` |
129127| ` ultra-tools ` | State-layer CLI — ` task ` , ` session ` , ` status ` , ` db ` , ` migrate ` ; explicit ` legacy-memory ` archive/prune migration |
130128| ` ubp-handbook ` | Preview/apply the managed Ultra contract in ` CLAUDE.md ` / ` AGENTS.md ` , with backup |
0 commit comments