🖥️ Troupe

A modern, project-aware terminal manager built with Tauri

Troupe treats workspaces as first-class citizens, allowing you to organize terminals by project with persistent sessions, snapshots, and a clean tabbed interface. Each project also gets ACP agent chats and Git and worktree tools, and the app adds SSH sessions and remote access from your phone.

Getting Started · Features · Documentation · Contributing · Report Bug · Request Feature

---

✨ Features

🪟 Workspace & Terminal Management

Feature	Description
Project-Based Workspaces	Organize terminals by project with dedicated workspace directories, separate state, and per-project configuration
Pane-Based Split Layout	Split your workspace into resizable panes and arrange terminals, editors, and browser tabs side by side
Tabbed Interface	Windows Terminal-style tab bar with drag-and-drop reordering within and across panes, terminal rename, and a context menu
Multiple Shell Support	Detects PowerShell, CMD, Git Bash, and WSL on Windows, and bash, zsh, fish, and sh on macOS and Linux. Pick a shell for each new terminal

🤖 AI Agents

Feature	Description
Agent Chat	Chat with ACP agents such as Claude Agent, Codex, Gemini CLI, Cursor, and OpenCode in any pane, with a model picker, slash commands, @ mentions of files and other chats, permission prompts, and a plan view
Saved Chats	Troupe saves chats per project and lists them in the sidebar. Reopen a chat when its agent can reload a past session
Agent Launcher	Start a chat from a prompt in the active pane (Ctrl+T), pick the agent and model, and optionally isolate the chat in a new Git worktree
Custom ACP Agents	Add your own ACP agents in Settings, or paste a Zed-style agent_servers config
Terminal AI Assist	Right-click selected terminal output and choose Explain with AI or Fix Command with AI. Suggested commands insert at the prompt without running

🌿 Git & Worktrees

Feature	Description
Changes & Commits	Stage, unstage, and discard files, then commit, amend, push, or publish the branch to origin
Partial Staging	Stage or unstage a single hunk or a selection of lines from the diff view
Diff Views	Inline and side-by-side diffs with word-level highlighting, opened as tabs
History Graph	Commit graph for all branches or the current branch, with search by message, author, or hash
Branches & Stash	Search, switch, and create branches, and save, apply, pop, or drop stashes
AI Commit Messages	Generate a commit message from the staged diff with the selected ACP agent
Worktrees	Create a worktree from any base branch and switch between worktrees from the workspace switcher
Status Bar	Shows the current branch, working directory, git status, and the last exit code

This is the beginning of the README. Read the rest at the original. Read the full README ↗