99 lines
2.6 KiB
Markdown
99 lines
2.6 KiB
Markdown
---
|
|
name: coding-agent
|
|
description: Run Claude Code, Codex CLI, or OpenCode via tmux for resilient coding sessions.
|
|
metadata: {"clawdis":{"emoji":"🧩","requires":{"bins":["tmux"],"anyBins":["claude","codex","opencode"]}}}
|
|
---
|
|
|
|
# Coding Agent (tmux-first)
|
|
|
|
Use **tmux** for all coding-agent CLIs. Keep sessions resumable and logs visible.
|
|
|
|
## Quick preflight
|
|
|
|
```bash
|
|
command -v claude codex opencode tmux
|
|
```
|
|
|
|
If none of `claude`, `codex`, `opencode` exist, stop and ask to install.
|
|
|
|
## tmux baseline
|
|
|
|
```bash
|
|
# Create or attach
|
|
tmux new -A -s coding-agent
|
|
|
|
# Split panes
|
|
tmux split-window -h
|
|
tmux split-window -v
|
|
|
|
# Leave running, detach
|
|
tmux detach
|
|
```
|
|
|
|
## Claude Code
|
|
|
|
Interactive (preferred in tmux):
|
|
- `claude` — start session
|
|
- `claude -c` — continue most recent
|
|
- `claude -r ""` — picker
|
|
- `claude -r <session_id>` — resume specific
|
|
|
|
## Codex CLI
|
|
|
|
⚠️ **Use gpt-5.2-codex — choose reasoning effort yourself:**
|
|
- `medium` — most tasks
|
|
- `high` — complex/architectural tasks
|
|
|
|
**One-shot with tmux (recommended):**
|
|
```bash
|
|
# IMPORTANT: Use bash workdir param to start in the target folder!
|
|
# This way Codex "wakes up in a little box" - only sees relevant files
|
|
|
|
# Start Codex in target directory (choose medium or high based on task complexity)
|
|
bash workdir:~/project/folder command:"tmux new -d -s codex-task 'codex exec --model gpt-5.2-codex -c reasoning_effort=\"medium\" -s workspace-write \"Your task\"'"
|
|
|
|
# Monitor progress
|
|
tmux capture-pane -t codex-task -p | tail -20
|
|
```
|
|
|
|
**Interactive:**
|
|
- `codex "Your prompt"`
|
|
- `codex resume`
|
|
- `codex resume --last`
|
|
- `codex resume --session <id>`
|
|
|
|
**Apply changes:**
|
|
- `codex apply`
|
|
|
|
**Useful flags:**
|
|
- `-s workspace-write` — Allow writing to workspace
|
|
- `--full-auto` — Sandboxed + auto-approve
|
|
- `-C <dir>` — Set working directory
|
|
- `--skip-git-repo-check` — Run outside git repos
|
|
|
|
## OpenCode
|
|
|
|
One-shot:
|
|
- `opencode run "Your task"`
|
|
- `opencode run -m anthropic/claude-sonnet-4-5 "Complex task"`
|
|
|
|
Interactive:
|
|
- `opencode`
|
|
- `opencode -c`
|
|
- `opencode -s <session-id>`
|
|
|
|
## Notes
|
|
|
|
- **Always prefer tmux** — keeps history, survives disconnects, allows monitoring
|
|
- For auth: `claude`, `codex login`, `opencode auth`
|
|
- Check tmux session: `tmux attach -t <session-name>`
|
|
- List sessions: `tmux list-sessions`
|
|
|
|
## ⚠️ IMPORTANT: Respect Tool Choice!
|
|
|
|
**If user asks for Codex/Claude Code/OpenCode → USE THAT TOOL!**
|
|
- NEVER offer to "just build it yourself" instead
|
|
- NEVER kill a running session because it's "too slow"
|
|
- Let the tool complete its work — be patient!
|
|
- The user wants to test/use that specific tool for a reason
|