[{"data":1,"prerenderedAt":52},["ShallowReactive",2],{"doc:en:introduction":3},{"title":4,"lede":5,"html":6,"headings":7},"Introduction","Escouade is a desktop app that runs several Claude Code agents side by side in a single window, on Windows, macOS and Linux. This page says what it is, who it is for, the words it uses and where to find the rest of the documentation.","\u003Ch2 id=\"what-escouade-is\">What Escouade is\u003C\u002Fh2>\n\u003Cp>\u003Ca href=\"https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Foverview\" rel=\"noopener\">Claude Code\u003C\u002Fa> 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:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>one tab per project, with the list of its agents;\u003C\u002Fli>\n\u003Cli>for each agent, a readable conversation: text in markdown, tool calls you can unfold, and questions and permission requests as cards you click;\u003C\u002Fli>\n\u003Cli>the files the agents change, their diffs and their commits, with a git worktree per agent if you want one;\u003C\u002Fli>\n\u003Cli>a file editor, terminals and commands to run the project;\u003C\u002Fli>\n\u003Cli>a Kanban board of tickets that agents pick up on their own, which is autopilot;\u003C\u002Fli>\n\u003Cli>notifications when an agent is waiting for your answer or has finished;\u003C\u002Fli>\n\u003Cli>the quotas of your subscription, the cost and usage statistics.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Each agent is a real Claude Code session: Escouade starts \u003Ccode class=\"key\">claude\u003C\u002Fcode> 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 \u003Ccode class=\"key\">~\u002F.escouade\u002F\u003C\u002Fcode> (see \u003Ca href=\"\u002Fen\u002Fdocs\u002Fdata\u002F\">local data\u003C\u002Fa>).\u003C\u002Fp>\n\u003Ch2 id=\"what-escouade-is-not\">What Escouade is not\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>An Anthropic product.\u003C\u002Fstrong> It is an independent project, not affiliated with Anthropic. Claude and Claude Code are trademarks of Anthropic.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>A replacement for Claude Code.\u003C\u002Fstrong> 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 \u003Ca href=\"\u002Fen\u002Fdocs\u002Finstallation\u002F\">installation\u003C\u002Fa>.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"who-it-is-for\">Who it is for\u003C\u002Fh2>\n\u003Cp>Anyone who programs with Claude Code and wants to run several agents at once without juggling terminals:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>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;\u003C\u002Fli>\n\u003Cli>you want to review and commit what each agent changed, without the agents stepping on each other;\u003C\u002Fli>\n\u003Cli>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;\u003C\u002Fli>\n\u003Cli>you have several Claude accounts (a personal one, a work one) and you want to keep an eye on their quotas.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"the-basic-concepts\">The basic concepts\u003C\u002Fh2>\n\u003Cp>These words come back throughout the interface and this documentation.\u003C\u002Fp>\n\u003Ch3 id=\"project\">Project\u003C\u002Fh3>\n\u003Cp>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 \u003Ca href=\"\u002Fen\u002Fdocs\u002Fquick-start\u002F\">quick start\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch3 id=\"agent-and-statuses\">Agent and statuses\u003C\u002Fh3>\n\u003Cp>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:\u003C\u002Fp>\n\u003Cdiv class=\"table\">\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Status\u003C\u002Fth>\n\u003Cth>What it means\u003C\u002Fth>\n\u003Cth>Sign\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>“Ready”\u003C\u002Ftd>\n\u003Ctd>The agent exists and has not received a request yet.\u003C\u002Ftd>\n\u003Ctd>Gray dot\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>“Running”\u003C\u002Ftd>\n\u003Ctd>Claude is working on a request.\u003C\u002Ftd>\n\u003Ctd>Green dot that pulses\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>“Question”\u003C\u002Ftd>\n\u003Ctd>Claude is waiting for your answer: a question or a permission request.\u003C\u002Ftd>\n\u003Ctd>Amber dot that pulses\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>“Done”\u003C\u002Ftd>\n\u003Ctd>Claude has finished its request.\u003C\u002Ftd>\n\u003Ctd>Green check mark\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>“Error”\u003C\u002Ftd>\n\u003Ctd>The request stopped on an error. A new message restarts Claude on the same session.\u003C\u002Ftd>\n\u003Ctd>Red dot\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\u003C\u002Fdiv>\n\u003Cp>See \u003Ca href=\"\u002Fen\u002Fdocs\u002Fmanaging-agents\u002F\">agents\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch3 id=\"conversation\">Conversation\u003C\u002Fh3>\n\u003Cp>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 \u003Ca href=\"\u002Fen\u002Fdocs\u002Fchat\u002F\">the conversation\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch3 id=\"ticket-and-kanban\">Ticket and Kanban\u003C\u002Fh3>\n\u003Cp>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 \u003Ca href=\"\u002Fen\u002Fdocs\u002Fboard\u002F\">the Kanban\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch3 id=\"autopilot\">Autopilot\u003C\u002Fh3>\n\u003Cp>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 \u003Ca href=\"\u002Fen\u002Fdocs\u002Fautopilot\u002F\">autopilot\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch3 id=\"worktree\">Worktree\u003C\u002Fh3>\n\u003Cp>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 \u003Ca href=\"\u002Fen\u002Fdocs\u002Fworktrees\u002F\">worktrees\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch3 id=\"claude-account\">Claude account\u003C\u002Fh3>\n\u003Cp>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 \u003Ca href=\"\u002Fen\u002Fdocs\u002Faccounts\u002F\">Claude accounts\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch3 id=\"overview\">Overview\u003C\u002Fh3>\n\u003Cp>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 \u003Ccode class=\"key\">Ctrl+Shift+A\u003C\u002Fcode>. See \u003Ca href=\"\u002Fen\u002Fdocs\u002Foverview\u002F\">keeping track of agents\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"supported-systems-and-languages\">Supported systems and languages\u003C\u002Fh2>\n\u003Cdiv class=\"table\">\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>System\u003C\u002Fth>\n\u003Cth>Versions\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Windows\u003C\u002Ftd>\n\u003Ctd>Windows 10 or 11\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>macOS\u003C\u002Ftd>\n\u003Ctd>macOS 11 (Big Sur) or later, on Apple Silicon or Intel Macs\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Linux\u003C\u002Ftd>\n\u003Ctd>x86-64, with glibc 2.35 or later (Ubuntu 22.04, Debian 12, Fedora 36 and later)\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\u003C\u002Fdiv>\n\u003Cp>The full requirements are in \u003Ca href=\"\u002Fen\u002Fdocs\u002Finstallation\u002F\">installation\u003C\u002Fa>.\u003C\u002Fp>\n\u003Cp>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 \u003Ca href=\"\u002Fen\u002Fdocs\u002Fsettings-application\u002F\">application settings\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"map-of-the-documentation\">Map of the documentation\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Get started\u003C\u002Fstrong>: \u003Ca href=\"\u002Fen\u002Fdocs\u002Finstallation\u002F\">installation\u003C\u002Fa>, the \u003Ca href=\"\u002Fen\u002Fdocs\u002Fquick-start\u002F\">quick start\u003C\u002Fa> and a tour of \u003Ca href=\"\u002Fen\u002Fdocs\u002Finterface\u002F\">the interface\u003C\u002Fa>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Agents and chat\u003C\u002Fstrong>: start with \u003Ca href=\"\u002Fen\u002Fdocs\u002Fmanaging-agents\u002F\">agents\u003C\u002Fa>, then the conversation, the overview, notifications, the Claude Code view and remote control.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Code and Git\u003C\u002Fstrong>: \u003Ca href=\"\u002Fen\u002Fdocs\u002Fgit\u002F\">Git and commits\u003C\u002Fa>, then worktrees, branches, the editor, terminals and running the project.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Kanban and automation\u003C\u002Fstrong>: \u003Ca href=\"\u002Fen\u002Fdocs\u002Fboard\u002F\">the Kanban\u003C\u002Fa>, then autopilot, testing and approving tickets, integrations and the MCP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Accounts and usage\u003C\u002Fstrong>: \u003Ca href=\"\u002Fen\u002Fdocs\u002Faccounts\u002F\">Claude accounts\u003C\u002Fa>, then quotas, cost and statistics.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Settings\u003C\u002Fstrong>: every tab of the settings window, option by option, starting with \u003Ca href=\"\u002Fen\u002Fdocs\u002Fsettings-application\u002F\">Application\u003C\u002Fa>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Reference\u003C\u002Fstrong>: the \u003Ca href=\"\u002Fen\u002Fdocs\u002Fshortcuts\u002F\">keyboard shortcuts\u003C\u002Fa>, local data, updates and \u003Ca href=\"\u002Fen\u002Fdocs\u002Ftroubleshooting\u002F\">troubleshooting\u003C\u002Fa>.\u003C\u002Fli>\n\u003C\u002Ful>\n",[8,12,15,18,21,25,28,31,34,37,40,43,46,49],{"id":9,"text":10,"depth":11},"what-escouade-is","What Escouade is",2,{"id":13,"text":14,"depth":11},"what-escouade-is-not","What Escouade is not",{"id":16,"text":17,"depth":11},"who-it-is-for","Who it is for",{"id":19,"text":20,"depth":11},"the-basic-concepts","The basic concepts",{"id":22,"text":23,"depth":24},"project","Project",3,{"id":26,"text":27,"depth":24},"agent-and-statuses","Agent and statuses",{"id":29,"text":30,"depth":24},"conversation","Conversation",{"id":32,"text":33,"depth":24},"ticket-and-kanban","Ticket and Kanban",{"id":35,"text":36,"depth":24},"autopilot","Autopilot",{"id":38,"text":39,"depth":24},"worktree","Worktree",{"id":41,"text":42,"depth":24},"claude-account","Claude account",{"id":44,"text":45,"depth":24},"overview","Overview",{"id":47,"text":48,"depth":11},"supported-systems-and-languages","Supported systems and languages",{"id":50,"text":51,"depth":11},"map-of-the-documentation","Map of the documentation",1791926756062]