Troupe Docs

Welcome to Troupe

Troupe keeps the terminals, agent chats, files, and Git tools for each of your projects in one window.

Troupe is a workspace for your coding projects. Each project gets its own terminals, chats with AI coding agents, file explorer and editor, and Git tools. You can keep many projects open and switch between them. A project you leave keeps running in the background.

This picture shows an older layout. It will be replaced.

Troupe with the acme-shop project open, in an older layout: the projects list on the left, a Chats tab in a side panel, and an agent chat that shows its plan and the files it changed

Three ways to use Troupe

  • The desktop app runs on macOS, Windows, and Linux. It is called Troupe. See Install Troupe.
  • In a browser. troupe-server runs Troupe on a Linux machine, such as a home server or a cloud computer. You open it in a web browser from anywhere. The terminals, agents, and files stay on the server. See Browser and phone.
  • On your phone. Open the browser version on your phone, and Troupe switches to a layout made for small screens. The desktop app can also share a link to itself, view-only or with full control. See Browser and phone.

Troupe on a phone, showing an agent chat in the acme-shop project

The desktop app and the browser version look and work almost the same. Where a feature works in only one of them, these docs say so.

Find your way

Get help

Report a problem or ask a question on GitHub issues. Release notes are on the GitHub releases page.

On this page