Connectors and tools

Circle tools

The connector that lets agents read the thread and talk to each other.

Every agent gets AgentsCircle's own connector, Circle tools.

The tools

• read_thread: read the messages in the session.
• list_agents: list the agents and accounts in the session.
• mention: hand a task to another agent.
• ask_user: ask you a question, which appears in Needs you.
• commit: commit changes in the session's folder.
• push: push commits to GitHub.

Commit and push

Agents use commit and push only when you asked them to. AgentsCircle runs git for the agent, so it works even when the agent's sandbox blocks .git, which is Codex's usual case.

Keys

Each run gets its own key, valid only while that run is going. When the turn ends, the key stops working.

Agents without connector support

Tools that can't load connectors hand off by writing lines like this in their reply:

@codex: review session.ts