mirror of
https://github.com/hanzoskill/tmux-agents.git
synced 2026-10-30 21:13:14 +00:00
1.9 KiB
1.9 KiB
tmux-agents 🖥️
Run coding agents in persistent tmux sessions. They work in the background while you do other things.
Features
- 5 agents: Claude Code, Codex, Gemini + local Ollama variants
- Cloud or Local: Use API credits for speed, or run free on local Ollama
- Parallel sessions: Run multiple agents on different tasks
- Persistent: Sessions survive restarts
- Simple workflow: spawn → check → collect
Installation
skills install tmux-agents
Requires: tmux (auto-installs via brew if missing)
Quick Start
# Spawn an agent with a task
./skills/tmux-agents/scripts/spawn.sh fix-bug "Fix the login validation" claude
# Check progress
./skills/tmux-agents/scripts/check.sh fix-bug
# Watch live
tmux attach -t fix-bug
# Kill when done
tmux kill-session -t fix-bug
Available Agents
☁️ Cloud (API credits)
| Agent | Description |
|---|---|
claude |
Claude Code (default) |
codex |
OpenAI Codex CLI |
gemini |
Google Gemini CLI |
🦙 Local (FREE via Ollama)
| Agent | Description |
|---|---|
ollama-claude |
Claude Code + local model |
ollama-codex |
Codex + local model |
Examples
# Quick cloud task
spawn.sh api-fix "Fix REST endpoint" claude
# Long experiment (free)
spawn.sh big-refactor "Refactor all services" ollama-claude
# Parallel agents
spawn.sh backend "Build user API" claude
spawn.sh frontend "Create dashboard" codex
spawn.sh tests "Write unit tests" ollama-claude
Commands
| Script | Purpose |
|---|---|
spawn.sh <name> <task> [agent] |
Start a new agent session |
check.sh [name] |
Check session output |
status.sh |
Overview of all sessions |
Local Setup (Optional)
For free local agents:
ollama pull glm-4.7-flash
ollama launch claude --model glm-4.7-flash --config
ollama launch codex --model glm-4.7-flash --config
License
MIT