tmux-agents

Tmux Agents

Run coding agents in persistent tmux sessions. They work in the background while you do other things.

Available Agents

☁️ Cloud Agents (API credits)

Agent	Command	Best For
claude	Claude Code	Complex coding, refactoring, full projects
codex	OpenAI Codex	Quick edits, auto-approve mode
gemini	Google Gemini	Research, analysis, documentation

🦙 Local Agents (FREE via Ollama)

Agent	Command	Best For
ollama-claude	Claude Code + Ollama	Long experiments, heavy refactoring
ollama-codex	Codex + Ollama	Extended coding sessions

Local agents use your Mac's GPU — no API costs, great for experimentation!

Quick Commands

Spawn a new agent session

./skills/tmux-agents/scripts/spawn.sh <name> <task> [agent]

# Cloud (uses API credits)
./skills/tmux-agents/scripts/spawn.sh fix-bug "Fix login validation" claude
./skills/tmux-agents/scripts/spawn.sh refactor "Refactor the auth module" codex
./skills/tmux-agents/scripts/spawn.sh research "Research caching strategies" gemini

# Local (FREE - uses Ollama)
./skills/tmux-agents/scripts/spawn.sh experiment "Rewrite entire test suite" ollama-claude
./skills/tmux-agents/scripts/spawn.sh big-refactor "Refactor all services" ollama-codex

List running sessions

tmux list-sessions
# or
./skills/tmux-agents/scripts/status.sh

Check on a session

./skills/tmux-agents/scripts/check.sh session-name

Attach to watch live

tmux attach -t session-name
# Detach with: Ctrl+B, then D

Send additional instructions

tmux send-keys -t session-name "additional instruction here" Enter

Kill a session when done

tmux kill-session -t session-name

When to Use Local vs Cloud

Scenario	Recommendation
Quick fix, time-sensitive	☁️ Cloud (faster)
Expensive task, budget matters	🦙 Local
Long experiment, might fail	🦙 Local
Production code review	☁️ Cloud (smarter)
Learning/exploring	🦙 Local
Heavy refactoring	🦙 Local

Parallel Agents

Run multiple agents simultaneously:

# Mix and match cloud + local
./scripts/spawn.sh backend "Implement user API" claude           # Cloud
./scripts/spawn.sh frontend "Build login form" ollama-codex      # Local
./scripts/spawn.sh docs "Write API documentation" gemini         # Cloud
./scripts/spawn.sh tests "Write all unit tests" ollama-claude    # Local

Check all at once:

./skills/tmux-agents/scripts/status.sh

Ollama Setup

Local agents require Ollama with a coding model:

# Pull recommended model
ollama pull glm-4.7-flash

# Configure tools (one-time)
ollama launch claude --model glm-4.7-flash --config
ollama launch codex --model glm-4.7-flash --config

Tips

• Sessions persist even if Clawdbot restarts
• Use local agents for risky/experimental work
• Use cloud for production-critical tasks
• Check tmux ls to see all active work
• Kill sessions when done to free resources