1354d0836f
- workdir 'little box' pattern (don't read unrelated files) - background mode replaces tmux - --full-auto for building, vanilla for reviewing - parallel Codex processes supported - PR review tips (fetch refs, use git diff, don't checkout) - patience rules (don't kill slow sessions!)
2.7 KiB
2.7 KiB
name, description, metadata
| name | description | metadata | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| coding-agent | Run Codex CLI, Claude Code, or OpenCode via background process for programmatic control. |
|
Coding Agent (background-first)
Use bash background mode for coding agents. Full programmatic control, no tmux needed.
The Pattern: workdir + background
# Start agent in target directory ("little box" - only sees relevant files)
bash workdir:~/project/folder background:true command:"<agent command>"
# Returns sessionId for tracking
# Monitor progress
process action:log sessionId:XXX
# Check if done
process action:poll sessionId:XXX
# Send input (if agent asks a question)
process action:write sessionId:XXX data:"y"
# Kill if needed
process action:kill sessionId:XXX
Why workdir matters: Agent wakes up in a focused directory, doesn't wander off reading unrelated files (like your soul.md 😅).
Codex CLI
Model: gpt-5.2-codex is the default (set in ~/.codex/config.toml)
Reasoning effort: Choose based on task complexity:
medium— most tasks (default)high— complex/architectural tasks
Building/Creating (use --full-auto)
bash workdir:~/project background:true command:"codex exec --full-auto \"Build a snake game with dark theme\""
Reviewing (vanilla, no flags needed)
bash workdir:~/project background:true command:"codex exec \"Review PR #115. Run git diff origin/main...origin/pr/115 to see changes.\""
Running Multiple Codex Processes
You can run many Codex processes in parallel! Each gets its own session:
# Start multiple reviews
bash workdir:~/project background:true command:"codex exec \"Review PR #1\""
bash workdir:~/project background:true command:"codex exec \"Review PR #2\""
bash workdir:~/project background:true command:"codex exec \"Review PR #3\""
# Check all running
process action:list
PR Review Tips
- Fetch PR refs first:
git fetch origin '+refs/pull/*/head:refs/remotes/origin/pr/*' - Tell Codex to use:
git diff origin/main...origin/pr/XX - Don't let it checkout branches (conflicts with parallel reviews)
Claude Code
bash workdir:~/project background:true command:"claude \"Your task\""
OpenCode
bash workdir:~/project background:true command:"opencode run \"Your task\""
⚠️ Rules
- Respect tool choice — if user asks for Codex, use Codex. NEVER offer to build it yourself!
- Be patient — don't kill sessions because they're "slow"
- Monitor with process:log — check progress without interfering
- --full-auto for building — auto-approves changes
- vanilla for reviewing — no special flags needed