agent-squad
Manage persistent AI coding squads that run in tmux sessions with task queues, progress reports, and automatic health monitoring. Use when the user wants to: (1) start/launch/create/restart a squad or team of AI agents, (2) assign/give tasks to a squad, (3) check squad status or ask what a squad is doing, (4) ping/nudge a squad to report progress, (5) stop a squad, (6) list all active squads, (7) configure squad settings like default project directory, (8) delete/archive a squad. Supports Claude Code, Codex, Gemini CLI, OpenCode, Kimi, Trae, Aider, and Goose as AI engines.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/0xtimi/agent-squadAgent Squad
GitHub: https://github.com/0xTimi/agent-squad
Run persistent AI coding squads in tmux. Squads pick up tasks, write code, and report progress — 24/7 in the background.
Slash Command Usage
Users can invoke /agent-squad directly with optional arguments:
| Command | Action |
|---|---|
/agent-squad | Show squad dashboard (or Getting Started if none exist) |
/agent-squad list | List all squads |
/agent-squad start my-squad claude | Start a squad |
/agent-squad status my-squad | Check squad status |
/agent-squad stop my-squad | Stop a squad |
/agent-squad assign my-squad "add login page" | Assign a task |
/agent-squad ping my-squad | Nudge squad to report |
/agent-squad delete my-squad | Archive a squad |
/agent-squad peek my-squad | Peek at squad's live tmux screen |
/agent-squad restart my-squad | Restart a stopped squad |
No arguments or list → run bash {baseDir}/scripts/squad-list.sh:
- If squads exist: show a clean status dashboard
- If no squads: show the Getting Started intro below
Getting Started
When users ask "what is this", "how do I use this", or invoke /agent-squad with no squads, give a friendly intro with usage examples. Match the user's language.
Agent Squad runs AI coding agents in the background 24/7. Just tell me what you need:
- "Start a squad called my-squad using claude for ~/projects/my-app"
- "Give my-squad a task: implement user login"
- "How's my-squad doing?"
- "Stop my-squad"
- "What squads do I have?"
Engines: Claude Code, Codex, Gemini CLI, OpenCode, Kimi, Trae, Aider, Goose
Want to start one now?
If the user asks which engine to use or doesn't specify one: default to claude — it is the most thoroughly tested engine and works best with Agent Squad. Mention other engines only if the user specifically asks. See {baseDir}/references/engines.md for details.
What Users Can Do
Users interact through natural language. Here's what they might say and how to respond:
Start a squad
User: "start a squad called my-squad with claude" / "launch a codex squad for ~/projects/api"
Ask if missing: squad name. Default engine to claude if not specified. Project dir and context are optional.
First-time users: briefly mention squads run in full-auto mode — the AI has full access to the project directory.
Response: "Squad 'my-squad' is up and running with Claude Code! You can assign tasks anytime."
Assign a task
User: "give my-squad a task: build the login page" / "let my-squad work on JWT auth"
If only one squad exists, use it automatically. If the request is vague, ask for specifics.
Response: "Task assigned! my-squad will start working on 'Login Page' shortly."
Check status
User: "how's my-squad doing?" / "what's the status?" / "is my-squad done yet?"
Include the live tmux screen output (from squad-status.sh) in the response — this lets the user see what the agent is actually doing right now.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-0xtimi-agent-squad": {
"enabled": true,
"auto_update": true
}
}
}