Files

Peter Steinberger 001a342f20 coding-agent: workdir pattern + patience rules

- Use bash workdir param so Codex wakes up in a 'little box'
- Prevents reading unrelated files (like my soul.md lol)
- Added rule: NEVER offer to build it yourself when user asks for Codex
- gpt-5.2-codex requires medium reasoning effort

2026-01-02 23:56:10 +00:00

3.1 KiB

Raw Blame History

name, description, metadata

name

description

metadata

coding-agent

Run Claude Code, Codex CLI, or OpenCode via tmux for resilient coding sessions.

clawdis

emoji

requires

🧩

bins

anyBins

tmux

claude

codex

opencode

Coding Agent (tmux-first)

Use tmux for all coding-agent CLIs. Keep sessions resumable and logs visible.

Quick preflight

command -v claude codex opencode tmux

If none of claude, codex, opencode exist, stop and ask to install.

tmux baseline

# 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

⚠️ Model-specific settings required!

Model	Config Needed
`gpt-4o`	Works with defaults
`gpt-5.2-codex`	Requires `-c reasoning_effort="medium"` (NOT low/high!)
`o3`	❌ Not available with ChatGPT accounts

One-shot with tmux (recommended):

# IMPORTANT: Use bash workdir param to start in the target folder!
# This way Codex "wakes up in a little box" - only sees relevant files

# Default model (gpt-4o)
bash workdir:~/project/folder command:"tmux new -d -s codex-task 'codex exec \"Your task\"'"

# gpt-5.2-codex (MUST use medium reasoning)
bash workdir:~/project/folder command:"tmux new -d -s codex-task 'codex exec --model gpt-5.2-codex -c reasoning_effort=\"medium\" \"Your task\"'"

# Full auto mode (sandboxed, auto-approve)
bash workdir:~/project/folder command:"tmux new -d -s codex-task 'codex exec --full-auto \"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 "Write a Python function that ..."
opencode run -m anthropic/claude-sonnet-4-5 "Complex task"
opencode run -m openai/gpt-5.2 "Coding task"
opencode run -m google/gemini-2.5-pro "Research task"

Interactive:

opencode
opencode -c
opencode -s <session-id>

Session management:

opencode session list
opencode export [sessionID]
opencode import <file>

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

3.1 KiB Raw Blame History