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

# Solo agents

> One specialist, no Manager: direct 1:1 work in Chat or Build mode.

A solo agent is a workspace with exactly one agent and no Manager. There is no delegation or team task board ceremony: just you and a specialist in a direct conversation.

## When to use a solo agent

* The work fits one role: explain this codebase, draft this document, review this folder.
* You already know which specialist you need.
* You want answers or edits now, without orchestration overhead.

If the work starts splitting into several kinds of tasks (build plus test plus document), graduate to a [team](/features/teams).

## Chat mode vs Build mode

Every solo agent runs in one of two modes, switchable from the toggle in its header:

| Mode      | What it can do                                                     | Best for                                       |
| --------- | ------------------------------------------------------------------ | ---------------------------------------------- |
| **Chat**  | Read, ask, plan. No file edits or commands.                        | Questions, planning, writing, research, review |
| **Build** | Full project work in the agent's folder: edit files, run commands. | Implementation, refactoring, file generation   |

The UI describes them as: "Chat mode: read, ask, plan. No file edits or commands." and "Build mode: full project work in the agent's folder."

## The solo workspace

The header shows the agent's avatar and status dot, its name and specialization, and a link to its working folder (click to open it in your file explorer). A **Files** toggle opens a live file tree of the working folder, refreshed while open. The settings icon opens the same [agent configuration panel](/features/agents#the-agent-configuration-panel) used in teams.

Everything else works like team chat: attachments, slash commands, steer and stop controls, tool approvals. See [Chat and dispatch](/features/chat-and-dispatch).

## Creating one

Use **Solo Agents** in the sidebar (+ button), or the team creation wizard's **Start from Scratch** path, then **Solo Agent**. You pick a name, an optional specialization, a model, a mode, and a workspace folder. Full walkthrough: [Create a solo agent](/guides/create-a-solo-agent).

## Solo limits

Your account tier sets how many solo workspaces you can have. Check Settings under **Account**.