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:
mochi desktopGetting around
| Page | What it's for |
|---|---|
| Home | Ask the agent, your favorites and your recent runs |
| Executables | Every task across every workspace, and templates for new ones |
| Workspaces | Your projects, and adding new ones |
| Runs | Every run, live and past, from the app, the terminal or an agent |
| Chats | Your conversations with the agent |
| Insights | What needs fixing and why, success rates, and where the time goes |
| Vault | Your secrets: add, link and copy them |
| Settings | Themes, 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.

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:
mochi desktop open my-project/tools:lintMake it yours
Pick one of seven themes in Settings → Appearance, and rebind any shortcut in Settings → Keyboard shortcuts. See Keyboard shortcuts for the defaults.