johno/beads
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(setup): add Codex CLI setup recipe (#1243)

Browse Source 
* Add Codex setup recipe

* Sync beads issues (bd-1zo)

---------

Co-authored-by: Amp <amp@example.com>
This commit is contained in:
matt wilkie
2026-01-21 22:50:01 -07:00
committed by GitHub
parent be306b6c66
commit ce622f5688
11 changed files with 537 additions and 1646 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/CLI_REFERENCE.md
View File

@@ -766,18 +766,21 @@ bd sync # Force immediate sync, bypass debounce
```bash
# Setup editor integration (choose based on your editor)
bd setup factory # Factory.ai Droid - creates/updates AGENTS.md (universal standard)
bd setup codex # Codex CLI - creates/updates AGENTS.md
bd setup claude # Claude Code - installs SessionStart/PreCompact hooks
bd setup cursor # Cursor IDE - creates .cursor/rules/beads.mdc
bd setup aider # Aider - creates .aider.conf.yml
# Check if integration is installed
bd setup factory --check
bd setup codex --check
bd setup claude --check
bd setup cursor --check
bd setup aider --check
# Remove integration
bd setup factory --remove
bd setup codex --remove
bd setup claude --remove
bd setup cursor --remove
bd setup aider --remove
@@ -792,6 +795,7 @@ bd setup claude --stealth # Use stealth mode (flush only, no git operations)
**What each setup does:**
- **Factory.ai** (`bd setup factory`): Creates or updates AGENTS.md with beads workflow instructions (works with multiple AI tools using the AGENTS.md standard)
- **Codex CLI** (`bd setup codex`): Creates or updates AGENTS.md with beads workflow instructions for Codex
- **Claude Code** (`bd setup claude`): Adds hooks to Claude Code's settings.json that run `bd prime` on SessionStart and PreCompact events
- **Cursor** (`bd setup cursor`): Creates `.cursor/rules/beads.mdc` with workflow instructions
- **Aider** (`bd setup aider`): Creates `.aider.conf.yml` with bd workflow instructions