> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agents-squads.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Frequently asked questions about Agents Squads

## General

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="What LLMs does it work with?">
    Claude (via Claude Code) is the default, most-tested provider. Gemini is
    also stable, and DeepSeek runs today via `aider` delegation for
    file-based roles. Codex, Mistral (`vibe`), Grok, and Ollama are wired in
    but experimental. Squads shells out to each provider's native CLI, so a
    single squad can mix models — see [Providers](/guides/multi-llm).
  </Accordion>
</AccordionGroup>

## Getting Started

<AccordionGroup>
  <Accordion title="How do I install the CLI?">
    ```bash theme={null}
    npm install -g squads-cli
    ```

    See the [Quickstart](/quickstart) for full setup instructions.
  </Accordion>

  <Accordion title="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](/guides/creating-agents).
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Architecture

<AccordionGroup>
  <Accordion title="What's the difference between an agent and a squad?">
    * **Agent**: A single AI worker with a specific purpose (defined in a `.md` file)
    * **Squad**: A team of agents organized around a business domain (defined in `SQUAD.md`)

    Squads share memory and coordinate on domain-specific tasks.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Pricing & Licensing

<AccordionGroup>
  <Accordion title="Is Agents Squads free?">
    The CLI and framework are open source. You pay only for the LLM usage (Claude API costs).
  </Accordion>

  <Accordion title="Is there an enterprise version?">
    Yes. Enterprise features include dedicated support, custom deployments, and SLA guarantees. [Contact us](/https://agents-squads.com/contact) for details.
  </Accordion>

  <Accordion title="Can I use this commercially?">
    Yes. The open source version is available under MIT license.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="My agent isn't producing expected results">
    Common causes:

    1. **Vague instructions** — Be specific about steps and output format
    2. **Missing context** — Check if memory is loaded correctly
    3. **Scope too broad** — Break into smaller, focused agents

    Run with `squads run <agent> --dry-run` to preview without executing.
  </Accordion>

  <Accordion title="Memory isn't persisting">
    Ensure you're running `squads memory write <squad> "<learning>"` after significant work. Check that `.agents/memory/` directory exists and has write permissions.
  </Accordion>

  <Accordion title="CLI command not found">
    Verify installation: `npm list -g squads-cli`

    If not installed: `npm install -g squads-cli`
  </Accordion>
</AccordionGroup>

## Still Have Questions?

<CardGroup cols={2}>
  <Card title="Contact Support" icon="envelope" href="https://agents-squads.com/contact">
    Get help from our team
  </Card>

  <Card title="GitHub Discussions" icon="github" href="https://github.com/agents-squads">
    Ask the community
  </Card>
</CardGroup>