Getting started

First session

Create a session, choose a folder or repository and pick your agents.

Create a session

Click New session. A session is one group chat tied to one project folder.

Choose where it works

The dialog has a switch with two options:

• Folder on this computer: pick any folder, for example ~/Projects/checkout-flow.
• GitHub repository: pick one of your repositories or paste a link. AgentsCircle clones it and opens the session in the clone. See Start from GitHub.

Pick agents

Tick the agents you want in the room. If you have more than one account for a tool, each account appears as its own chip, for example @claude · work and @claude · personal.

Bring context (optional)

Add notes, requirements, files and images in the Context field. Every agent gets them with each task. See Session context. To bring in a full terminal conversation instead, see Bring in a chat.

Send the first message

Type @ in the composer to see the agents in the session, pick one, and describe the task:

@codex look through the auth code and list what's broken