Troupe Docs
Getting started

Command palette

Find projects and chats, and run commands from one search box.

The command palette is a search box for projects, chats, and commands. Use it to switch projects, find a chat, open a terminal, change the theme, and more, without the mouse.

Open the palette

Use one of these:

  • Press Ctrl+K (Cmd+K on macOS).
  • Press Ctrl+Shift+P (Cmd+Shift+P on macOS).
  • Select Search at the top of the sidebar.

Both keys open the same palette, in the desktop app and in the browser.

The command palette with the Projects group listing acme-shop, payments-api, and blog, and the Workspace group with New Terminal, Agent Launcher, Launch Agent, and Save Workspace Snapshot

Run a command

  1. Type a few letters of what you want. The list keeps only the items that match.
  2. Press Up and Down to move through the list.
  3. Press Enter to run the selected item, or select it with the mouse.

Press Esc to close the palette.

The palette matches the names and descriptions of commands, and the names and folders of projects. It doesn't search the files in your project. To search files, use the file explorer.

Find a chat

Type part of a chat's title. For the chats of the active project, the agent, the branch, and the model match too. Matching chats show first, under Chats, before the commands. The group lists the chats of the active project, in all of its worktrees. Chats without a project show under Quick chats, and match by title only. Select a chat to open it.

The chat groups show only while you type. With an empty search box, the palette shows commands.

The command palette after typing history, showing the payments-api project, Command History, and Open Shortcut Menu

Pin the commands you use most

  1. Open the palette and hover over a command, or move to it with the arrow keys.
  2. Select the pin icon at the right of the row.

Pinned commands show at the top of the palette, under Pinned, until you unpin them. To unpin a command, select its pin icon again.

Under Pinned, the palette shows Recent, the last five commands you ran. Both groups show only while the search box is empty.

What you can do from the palette

The palette groups its items in this order.

Projects lists every project with its folder. Select one to switch to it.

Workspace has these commands:

  • New Terminal opens a terminal in the active pane.
  • New Terminal: <name> opens a terminal from one of your saved terminal profiles. See Terminals.
  • New chat starts a new chat in the active pane. Its shortcut is shown next to it. See Start a chat.
  • New quick chat starts a chat that has no project. See Start a chat.
  • Launch Agent opens a command-line agent in a terminal in the active pane.
  • New Browser Tab opens a web page in Troupe. Desktop app only.
  • Save Workspace Snapshot saves the terminals you have open so you can bring them back later. See Terminals.
  • Open Canvas opens the project's design document.
  • New Project creates a project. This command is in the phone layout only. Elsewhere, use the + menu next to Projects in the sidebar.

Navigation has these commands:

  • Project Settings opens the settings of the current project.
  • App Preferences opens the app settings.

Tools has these commands:

  • Command History opens a searchable list of the commands you ran in terminals. It shows when a project is open.
  • Change Color Theme opens the theme picker.
  • Open Shortcut Menu shows the most used shortcuts so you can change them.
  • Report a Bug opens the bug report form.
  • SSH: <host> connects to a saved SSH host. Desktop app only. See SSH.

On this page