Skip to content

Desktop App ​

The desktop app is one window for every project on your machine. It shares everything with the mochi CLI, so the app and the terminal always agree on what exists and what ran.

Open it from your applications, or from a terminal:

sh
mochi desktop

Getting around ​

PageWhat it's for
HomeAsk the agent, your favorites and your recent runs
ExecutablesEvery task across every workspace, and templates for new ones
WorkspacesYour projects, and adding new ones
RunsEvery run, live and past, from the app, the terminal or an agent
ChatsYour conversations with the agent
InsightsWhat needs fixing and why, success rates, and where the time goes
VaultYour secrets: add, link and copy them
SettingsThemes, shortcuts, AI, trust, containers and your license

Below those, the sidebar lists the views you've built. New at the top of the sidebar creates a workspace, an executable, a template or a view.

The status bar shows what's running. Its bell opens the Inbox: notifications you missed, and anything still running, so you can stop it.

Find anything with ⌘K ​

The command palette (Ctrl+K on Linux and Windows) searches tasks, workspaces and pages. It ranks results by what you actually run, so your everyday tasks come first.

Run a task ​

Open a task and choose Run. If it takes arguments, Mochi asks for them first. The output streams live into its own tab, and you can open as many as you like: tasks, runs and workspaces open as tabs, like files in an editor, and they're still there next time you open the app.

A build streaming its output in its own tab, with Stop beside it

Run from the tray ​

Turn on Close to tray in Settings → General, and closing the window leaves Mochi in the system tray, so a long build or a dev server keeps going. From the tray menu you can:

  • run a favorite task, or Run again the last one, without opening the window
  • see what's Running, then View output or Stop it
  • rerun something from Recent, which marks how each run ended
  • open a favorite workspace, or Run discovery to scan the current one for task files

The window only comes forward when a run needs you, such as to fill in its arguments or trust its workspace. When a run finishes while Mochi is in the background, a system notification tells you how it went. Turn that off with System notifications in Settings → General.

Open at login in the same place starts Mochi when you log in. On macOS and Windows it starts in the tray.

Open from the terminal ​

mochi desktop open jumps straight to a task in the app, launching it if needed:

sh
mochi desktop open my-project/tools:lint

Make it yours ​

Pick one of seven themes in Settings → Appearance, and rebind any shortcut in Settings → Keyboard shortcuts. See Keyboard shortcuts for the defaults.

Next ​