Your first buddy in a few minutes

Buddies brings your Claude Code and Codex sessions into a local workspace. A character represents a session; a house represents a project. The map helps you see who is working and who needs a decision.

1. Install the app

Read the installation guide to choose your platform. Claude Code or Codex must be installed and signed in to your account in the environment where the engine runs. Buddies does not provide a provider subscription or API key.

2. Create a space

Choose Create a space, then your project folder. Its house appears in the village. Set the default folder for future projects in Settings → General.

3. Welcome a buddy

Click a house or Add a buddy. Choose the project, describe a task and select Claude or Codex. The first prompt names the conversation; a temporary name is optional.

In a Git repository, sessions created by Buddies use a worktree to isolate their work. Outside Git, they work directly in the selected folder. Check the displayed folder before starting a task.

4. Join the conversation

Select the character or its row in the list. The terminal opens first when available. You can answer provider questions and choices directly from the keyboard. The History tab remains available to review messages.

An external session may expose its history without offering an attachable terminal. Buddies explains that limitation and never duplicates an active session to simulate an attachment.

5. Review the result

Open Changes to review the buddy’s diff, then send feedback. A mission can involve several roles in sequence, with human approval between stages.

Closing the Buddies window does not stop its managed sessions. To end an agent, use its action menu. Understand sessions and their states →