tmux-agents — Skillopedia

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-c…

| tail -1)\n if [ -n \"$LAST_LINE\" ]; then\n echo \" Status: ${LAST_LINE:0:60}...\"\n fi\n echo \"\"\ndone\n\necho \"Commands:\"\necho \" Check: ./skills/tmux-agents/scripts/check.sh \u003cname>\"\necho \" Attach: tmux attach -t \u003cname>\"\necho \" Kill: tmux kill-session -t \u003cname>\"\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":832,"content_sha256":"9754a0924c54d404049461672d3da50d1324fb38786528a27849a7056834220d"}],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Tmux Agents","type":"text"}]},{"type":"paragraph","content":[{"text":"Run coding agents in persistent tmux sessions. They work in the background while you do other things.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Available Agents","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"☁️ Cloud Agents (API credits)","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Agent","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Command","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Best For","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"claude","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Claude Code","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Complex coding, refactoring, full projects","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"codex","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"OpenAI Codex","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Quick edits, auto-approve mode","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"gemini","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Google Gemini","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Research, analysis, documentation","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"🦙 Local Agents (FREE via Ollama)","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Agent","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Command","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Best For","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"ollama-claude","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Claude Code + Ollama","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Long experiments, heavy refactoring","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"ollama-codex","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Codex + Ollama","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Extended coding sessions","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Local agents use your Mac's GPU — no API costs, great for experimentation!","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Quick Commands","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Spawn a new agent session","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"./skills/tmux-agents/scripts/spawn.sh \u003cname> \u003ctask> [agent]\n\n# Cloud (uses API credits)\n./skills/tmux-agents/scripts/spawn.sh fix-bug \"Fix login validation\" claude\n./skills/tmux-agents/scripts/spawn.sh refactor \"Refactor the auth module\" codex\n./skills/tmux-agents/scripts/spawn.sh research \"Research caching strategies\" gemini\n\n# Local (FREE - uses Ollama)\n./skills/tmux-agents/scripts/spawn.sh experiment \"Rewrite entire test suite\" ollama-claude\n./skills/tmux-agents/scripts/spawn.sh big-refactor \"Refactor all services\" ollama-codex","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"List running sessions","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"tmux list-sessions\n# or\n./skills/tmux-agents/scripts/status.sh","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Check on a session","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"./skills/tmux-agents/scripts/check.sh session-name","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Attach to watch live","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"tmux attach -t session-name\n# Detach with: Ctrl+B, then D","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Send additional instructions","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"tmux send-keys -t session-name \"additional instruction here\" Enter","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Kill a session when done","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"tmux kill-session -t session-name","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"When to Use Local vs Cloud","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Scenario","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Recommendation","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Quick fix, time-sensitive","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"☁️ Cloud (faster)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Expensive task, budget matters","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"🦙 Local","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Long experiment, might fail","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"🦙 Local","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Production code review","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"☁️ Cloud (smarter)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Learning/exploring","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"🦙 Local","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Heavy refactoring","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"🦙 Local","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Parallel Agents","type":"text"}]},{"type":"paragraph","content":[{"text":"Run multiple agents simultaneously:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"# Mix and match cloud + local\n./scripts/spawn.sh backend \"Implement user API\" claude # Cloud\n./scripts/spawn.sh frontend \"Build login form\" ollama-codex # Local\n./scripts/spawn.sh docs \"Write API documentation\" gemini # Cloud\n./scripts/spawn.sh tests \"Write all unit tests\" ollama-claude # Local","type":"text"}]},{"type":"paragraph","content":[{"text":"Check all at once:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"./skills/tmux-agents/scripts/status.sh","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Ollama Setup","type":"text"}]},{"type":"paragraph","content":[{"text":"Local agents require Ollama with a coding model:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"# Pull recommended model\nollama pull glm-4.7-flash\n\n# Configure tools (one-time)\nollama launch claude --model glm-4.7-flash --config\nollama launch codex --model glm-4.7-flash --config","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Tips","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Sessions persist even if Clawdbot restarts","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use local agents for risky/experimental work","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Use cloud for production-critical tasks","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Check ","type":"text"},{"text":"tmux ls","type":"text","marks":[{"type":"code_inline"}]},{"text":" to see all active work","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Kill sessions when done to free resources","type":"text"}]}]}]},{"type":"hr","attrs":{"markup":"---"}}]},"metadata":{"date":"2026-06-05","name":"tmux-agents","author":"@skillopedia","source":{"stars":609,"repo_name":"awesome-openclaw-skills","origin_url":"https://github.com/sundial-org/awesome-openclaw-skills/blob/HEAD/skills/tmux-agents/SKILL.md","repo_owner":"sundial-org","body_sha256":"1c1d19889624907f1384f22899a194948e2e0ca176353135855c463f3d071a2f","cluster_key":"271c608916b502153a0cf896b4506da92802e5193802134b40ef44ce4454fcfe","clean_bundle":{"format":"clean-skill-bundle-v1","source":"sundial-org/awesome-openclaw-skills/skills/tmux-agents/SKILL.md","attachments":[{"id":"6cd67676-f95e-5b78-8421-da59abe39128","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/6cd67676-f95e-5b78-8421-da59abe39128/attachment.md","path":"README.md","size":1959,"sha256":"4dd54570d64e36d2d566b3700febe2ebc51ec6536f11ad949b1718ebacb93af4","contentType":"text/markdown; charset=utf-8"},{"id":"765482e4-5e98-54e3-bbb0-7243d7d627a8","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/765482e4-5e98-54e3-bbb0-7243d7d627a8/attachment.sh","path":"scripts/check.sh","size":546,"sha256":"48db1250d000d6798cc63371576ad7b8526625c45ef4a4f44e78803aa2716d25","contentType":"application/x-sh; charset=utf-8"},{"id":"09693945-0ab7-55dd-ba25-74d5f3da667a","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/09693945-0ab7-55dd-ba25-74d5f3da667a/attachment.sh","path":"scripts/spawn.sh","size":3583,"sha256":"257258b95b3bc4053d5ef82758a347f523e708adabef2577d6e3479f40ae74c4","contentType":"application/x-sh; charset=utf-8"},{"id":"461ce69f-463d-5c96-9bec-478bbf199c44","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/461ce69f-463d-5c96-9bec-478bbf199c44/attachment.sh","path":"scripts/status.sh","size":832,"sha256":"9754a0924c54d404049461672d3da50d1324fb38786528a27849a7056834220d","contentType":"application/x-sh; charset=utf-8"}],"bundle_sha256":"43204d39271ee0c9b535237788d22b80ae8d0d9f2533119b027184b146c4259f","attachment_count":4,"text_attachments":4,"attachment_storage":"skillopedia-attachments-v1","binary_attachments":0,"excluded_attachments":[]},"cluster_size":1,"skill_md_path":"skills/tmux-agents/SKILL.md","import_metadata":{"date":"2026-06-05","author":"@skillopedia","version":"v1","category":"design-ux","category_label":"Design"},"exact_dupes_collapsed_into_this":0},"version":"v1","category":"design-ux","homepage":"https://clawdhub.com/skills/tmux-agents","metadata":{"clawdbot":{"emoji":"🖥️","install":[{"id":"brew-tmux","bins":["tmux"],"kind":"brew","label":"Install tmux (brew)","formula":"tmux"}],"requires":{"bins":["tmux"]}}},"triggers":["spawn agent","coding task","background task","tmux session","run codex","run gemini","local agent","ollama agent"],"import_tag":"clean-skills-v1","description":"Manage background coding agents in tmux sessions. Spawn Claude Code or other agents, check progress, get results."}},"renderedAt":1782980780145}

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.