Introduction

What Escouade is

Claude Code is Anthropic’s command-line tool for programming with Claude. Escouade runs as many instances of it as you want, each in its own conversation, and brings them together in a single window:

• one tab per project, with the list of its agents;
• for each agent, a readable conversation: text in markdown, tool calls you can unfold, and questions and permission requests as cards you click;
• the files the agents change, their diffs and their commits, with a git worktree per agent if you want one;
• a file editor, terminals and commands to run the project;
• a Kanban board of tickets that agents pick up on their own, which is autopilot;
• notifications when an agent is waiting for your answer or has finished;
• the quotas of your subscription, the cost and usage statistics.

Each agent is a real Claude Code session: Escouade starts claude for it and shows its conversation. The session also stays on your disk, in Claude Code’s own files. The app runs on your machine: your projects, conversations and settings are in ~/.escouade/ (see local data).

What Escouade is not

• An Anthropic product. It is an independent project, not affiliated with Anthropic. Claude and Claude Code are trademarks of Anthropic.
• A replacement for Claude Code. Claude Code must be installed on the machine and signed in to your Claude account: Escouade contains no model and no subscription, it uses yours. See installation.

Who it is for

Anyone who programs with Claude Code and wants to run several agents at once without juggling terminals:

• you work on several tasks or several projects at the same time, and you want to see at a glance which agent is working, which one is waiting for your answer and which one has finished;
• you want to review and commit what each agent changed, without the agents stepping on each other;
• you write your tasks as tickets, in Escouade or in Jira, Trello, GitHub Issues or Linear, and you want to hand them to agents that keep going until the acceptance criteria are met;
• you have several Claude accounts (a personal one, a work one) and you want to keep an eye on their quotas.

The basic concepts

These words come back throughout the interface and this documentation.

Project

A project is a folder of code, opened in a tab of the title bar. It has its own color, agents, Kanban, terminals and settings. If the folder is not a git repository, Escouade initializes one when the project is created. See the quick start.

Agent and statuses

An agent is a conversation with Claude Code in a project. It always has one of these five statuses, which you read in the sidebar, in the header of its conversation and in the status bar:

See agents.

Conversation

The conversation is the exchange between you and an agent: your messages, Claude’s replies, its tool calls and the cards for questions and permissions. It is kept from one restart to the next, and each agent picks its Claude session up where it left off. See the conversation.

Ticket and Kanban

A ticket describes a task: a title, a description and acceptance criteria. A project’s Kanban, opened with the “Kanban” button of the sidebar, sorts tickets into four columns: “To do”, “In progress”, “To review” and “Done”. An agent takes a ticket, works on it and loops until its criteria are met; you test it, then you approve it. You can also import tickets from Jira, Trello, GitHub Issues and Linear. See the Kanban.

Autopilot

Autopilot is what starts the “To do” tickets by itself as soon as a slot is free. It is on by default for a project: the “In parallel” setting sets how many agents take tickets at the same time (from 1 to 6, 2 by default), each in its own worktree. It pauses near the limit of your quotas (the “Pause above quota” setting). See autopilot.

Worktree

A worktree is a separate working copy of your repository, on its own branch. With the “One git worktree per agent” option, each new agent works in its own: its changes mix neither with those of the other agents nor with your folder, and you review and merge them afterwards. The agents of tickets each work in their own worktree. See worktrees.

Claude account

A Claude account is a Claude Code configuration folder, with its sign-in. “Main” is your usual account, started as before; you can add others (a personal one, a work one) in Settings › Claude accounts. Each agent stays on its account. See Claude accounts.

Overview

The “Overview” is a page that lists the agents of all projects, the ones waiting for your answer first. You open it with its button in the title bar or with Ctrl+Shift+A. See keeping track of agents.

Supported systems and languages

The full requirements are in installation.

The interface comes in French and English. By default it follows the system language: French if the system is in French, English otherwise. Settings › Application lets you pick either one without restarting, and pick separately the language of the texts Claude writes (commit messages, pull request descriptions, comments posted to Jira, Trello, GitHub and Linear, instructions given to agents), because many teams commit in English with an interface in French. See the application settings.

Map of the documentation

• Get started: installation, the quick start and a tour of the interface.
• Agents and chat: start with agents, then the conversation, the overview, notifications, the Claude Code view and remote control.
• Code and Git: Git and commits, then worktrees, branches, the editor, terminals and running the project.
• Kanban and automation: the Kanban, then autopilot, testing and approving tickets, integrations and the MCP server.
• Accounts and usage: Claude accounts, then quotas, cost and statistics.
• Settings: every tab of the settings window, option by option, starting with Application.
• Reference: the keyboard shortcuts, local data, updates and troubleshooting.