openagentsbtw

Cross-platform agent scaffolding for Claude Code, Codex CLI, OpenCode, GitHub Copilot, and detected IDE agent surfaces.

One canonical source tree. Generated platform artifacts. Tight prompts, strict routing, and fewer chances for models to drift into garbage architecture or generic AI UI.

What Changed In 3.1

• optional IDE support for Roo Code, Cline, Cursor, JetBrains Junie, and Antigravity
• ./install.sh --all auto-detects optional IDEs and skips missing systems without writing files
• project-native rule/instruction assets for optional IDEs, with Cline prompt hooks where supported

What Changed In 3.0

• canonical source split into smaller catalogs instead of one giant registry blob
• SRP command and skill names
• Codex wrapper surface moved toward verb + modifier routing
• deterministic Codex defaults now use gpt-5.4 for top-level plan/edit on eligible plans (plus, pro-5, pro-20) while implementation routes stay on gpt-5.3-codex
• new cross-platform design-polish skill for frontend/UI refinement
• old scattered docs replaced by a smaller consolidated doc set
• agentic-ides surfaces removed from installer and generated assets
• Caveman now references upstream via pinned submodule at third_party/caveman
• Copilot hooks now emit fallback events for documented compatibility surfaces

Architecture

Canonical authored source lives under source/:

• source/agents/<agent>/ -- agent metadata and prompt
• source/skills/<skill>/ -- skill metadata and body
• source/skills/<skill>/ -- skill bodies, references, scripts
• source/commands/{codex,copilot,opencode}/ -- command catalogs per surface
• source/catalog/loaders.mjs -- canonical catalog loader
• scripts/generate.mjs -- thin generation entrypoint

Generated targets:

• claude/
• codex/
• opencode/
• copilot/

More detail: docs/architecture.md

Install

git clone https://github.com/xsyetopz/openagentsbtw.git
cd openagentsbtw
./install.sh --all

Common presets:

./install.sh --codex --codex-plan pro-5
./install.sh --claude --claude-plan max-5
./install.sh --copilot --copilot-plan pro
./install.sh --all --caveman-mode full
./install.sh --all --no-optional-ides
./install.sh --optional-ides

Codex Surface

Main verbs:

oabtw-codex explore "<target>"
oabtw-codex plan "<goal>"
oabtw-codex implement "<task>"
oabtw-codex review "<scope>"
oabtw-codex validate "<scope>"
oabtw-codex document "<task>"
oabtw-codex deslop "<target>"
oabtw-codex design-polish "<ui task>"
oabtw-codex orchestrate "<task>"
oabtw-codex resume --last
oabtw-codex queue add "follow up after the current task"

Modifiers:

oabtw-codex explore --source deepwiki "<github repo task>"
oabtw-codex implement --approval auto "<task>"
oabtw-codex review --speed fast "<scope>"
oabtw-codex validate --runtime long "<suite>"

More detail: docs/platforms/codex.md

Development

bun install --frozen-lockfile
bun run generate
bun test tests claude/tests codex/tests
cd opencode && bun install --frozen-lockfile && bun test && bun run typecheck

Attribution

• Caveman mode draws from JuliusBrussee/caveman.
• design-polish incorporates ideas from cyxzdev/Uncodixfy, anthropics/skills frontend-design, and pbakaus/impeccable.

License

MIT