tmux-agents
Manage background coding agents in tmux sessions. Spawn Claude Code or other agents, check progress, get results.
Informações da origem
- Repositório
- ThinkfleetAI/thinkfleet-engine
- Última atividade na origem
- 10 de fevereiro de 2026 às 19:23
- Idioma detectado do SKILL.md
- inglês
- Estrelas
- 0
- Forks
- 0
Opções de instalação
Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.
Revise os arquivos de origem
Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.
Exibindo SKILL.md
SKILL.md
Instruções da origem · Visualização somente leitura- name
- tmux-agents
- description
- Manage background coding agents in tmux sessions. Spawn Claude Code or other agents, check progress, get results.
- version
- 1.0.0
- author
- Jose Munoz
- homepage
- https://thinkfleet-hub.com/skills/tmux-agents
- triggers
- ["spawn agent","coding task","background task","tmux session","run codex","run gemini","local agent","ollama agent"]
- metadata
- {"thinkfleet":{"emoji":"🖥️","requires":{"bins":"[Truncated]"},"install":["[Truncated]"]}}
# 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
```bash
./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
```bash
tmux list-sessions
# or
./skills/tmux-agents/scripts/status.sh
```
### Check on a session
```bash
./skills/tmux-agents/scripts/check.sh session-name
```
### Attach to watch live
```bash
tmux attach -t session-name
# Detach with: Ctrl+B, then D
```
### Send additional instructions
```bash
tmux send-keys -t session-name "additional instruction here" Enter
```
### Kill a session when done
```bash
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:
```bash
# 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:
```bash
./skills/tmux-agents/scripts/status.sh
```
## Ollama Setup
Local agents require Ollama with a coding model:
```bash
# 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 ThinkFleet 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
Ver no GitHub