Find, join and manage your agents
One session, one character
The village represents agents across your projects. The sidebar groups them by space. Clicking a buddy opens its working context; its project and provider remain visible.
| State | Meaning |
|---|---|
| Working | The provider reports ongoing activity. |
| Needs help | A request needs your input. The buddy joins the queue at your desk. |
| Resting | Available information indicates that the session is waiting for a new task. |
| Ended | The session or process has ended; its history remains available. |
| Error | An operation failed and needs your attention. |
A silent terminal is not proof that an agent is resting. When a state is uncertain, Buddies preserves that uncertainty.
The desk queue
Requests appear in the order the app first observes them. Sending a message or marking a notification as read does not automatically resolve a request: the provider must report the state change.
Action required groups requests for intervention. Recent activity includes turn completions, grouped by buddy to reduce noise.
Managed and external sessions
A session created in Buddies has an independent supervisor. You can detach and rejoin its terminal without restarting the agent. After stopping it, Resume reuses its conversation and folder when supported.
Sessions started elsewhere are detected using information exposed by Claude Code or Codex. Capabilities vary: history, messaging and terminals are not always available. Native permissions may need approval in the original app. External Claude messaging uses an unofficial protocol; a successful socket write is not proof of delivery.
Sub-agents
Active sub-agents appear as smaller characters next to the buddy that launched them. Their visibility depends on events and parent relationships exposed by the provider. They do not form a separate queue of independent characters.
Stop or remove
Interrupt applies to an active turn. Stop ends a session when supported by the provider. Remove from village hides an entry; it does not delete the project or its worktree.
Buddies never automatically approves provider permission requests.