General
What is Agents Squads?
What is Agents Squads?
Agents Squads is a framework for building transparent AI agent systems. Instead of black-box AI, you get agents defined in simple markdown files that your team can understand, modify, and own.
How is this different from other agent frameworks?
How is this different from other agent frameworks?
Most frameworks focus on capability. We focus on transparency and trust:
- Agents are markdown files, not code
- Full visibility into what agents do and why
- No vendor lock-in—you own everything
- Designed for teams, not just developers
Do I need to know how to code?
Do I need to know how to code?
No. Agents are defined in markdown. If you can write a document, you can create an agent. The CLI handles execution.
What LLMs does it work with?
What LLMs does it work with?
Currently optimized for Claude via Claude Code. Support for other models is planned.
Getting Started
How do I install the CLI?
How do I install the CLI?
How do I create my first agent?
How do I create my first agent?
Create a markdown file in
.agents/squads/<squad>/<agent>.md with Purpose, Inputs, Outputs, and Instructions sections. See Creating Agents.Can I use this with an existing project?
Can I use this with an existing project?
Yes. Run
squads init in your project root. It creates the .agents/ directory structure without touching your existing code.Architecture
What's the difference between an agent and a squad?
What's the difference between an agent and a squad?
- Agent: A single AI worker with a specific purpose (defined in a
.mdfile) - Squad: A team of agents organized around a business domain (defined in
SQUAD.md)
How does memory work?
How does memory work?
Memory is stored in
.agents/memory/ as markdown files. When an agent runs, relevant memory is loaded into context. After execution, new learnings are stored. This gives agents continuity across sessions.Can agents communicate with each other?
Can agents communicate with each other?
Agents in the same squad share memory, which enables coordination. For direct handoffs, you can chain agent executions or use an orchestrator pattern.
Pricing & Licensing
Is Agents Squads free?
Is Agents Squads free?
The CLI and framework are open source. You pay only for the LLM usage (Claude API costs).
Is there an enterprise version?
Is there an enterprise version?
Yes. Enterprise features include dedicated support, custom deployments, and SLA guarantees. Contact us for details.
Can I use this commercially?
Can I use this commercially?
Yes. The open source version is available under MIT license.
Troubleshooting
My agent isn't producing expected results
My agent isn't producing expected results
Common causes:
- Vague instructions — Be specific about steps and output format
- Missing context — Check if memory is loaded correctly
- Scope too broad — Break into smaller, focused agents
squads run <agent> --dry-run to preview without executing.Memory isn't persisting
Memory isn't persisting
Ensure you’re running
squads memory update <squad> after significant work. Check that .agents/memory/ directory exists and has write permissions.CLI command not found
CLI command not found
Verify installation:
npm list -g @agents-squads/cliIf not installed: npm install -g @agents-squads/cli