Skip to content

Desktop App

Meowbert Desktop uses the same core product UI as the web app, with a few native integrations layered on top. This page shows where those desktop-only features live and how to use them.

Downloads

macOS downloads are currently unsigned preview builds. In-app auto-update is enabled on Windows first; macOS auto-update lands once signed and notarized releases are available.

Switching servers

When you first open Meowbert Desktop, you'll see a welcome screen with two choices:

  • Default — connects to the standard Meowbert Cloud server.
  • Advanced — lets you add other hosted servers or a local server running on this computer.

After setup, you can reopen server settings any time from either of these places:

  • The Server: ... button near the bottom of the sidebar.
  • The command palette action Desktop Server Profiles.

Desktop preferences

Desktop-only settings live in Desktop Preferences.

You can open that page from:

  • the Desktop Preferences button in the sidebar,
  • the command palette action Desktop Preferences,
  • the app menu item View → Desktop Preferences.

Right now, Desktop Preferences includes a dedicated Keyboard Shortcuts section where you can:

  • change the global Quick Agent shortcut,
  • change the in-app desktop shortcuts,
  • clear a shortcut,
  • reset everything back to the defaults.

Keyboard shortcuts

These shortcuts are configurable in Desktop Preferences.

Default shortcutAction
Cmd/Ctrl + Shift + SpaceOpen Quick Agent from anywhere on your computer
Cmd/Ctrl + KOpen the command palette
Cmd/Ctrl + NStart a new task in the current project
Cmd/Ctrl + Shift + FOpen the Files page for the current project
Cmd/Ctrl + Shift + TOpen the Terminal page for the current project
Cmd/Ctrl + Shift + UOpen the native file picker
Cmd/Ctrl + Shift + OOpen the current project folder in Finder / Explorer / your file manager

Quick Agent

Quick Agent is a floating desktop composer that can be opened even while you're in another app.

It uses the same task input UI as the normal composer, including:

  • file attachments,
  • tool toggles,
  • skills,
  • agent selection.

By default, Quick Agent sends the new task to your most recently used workspace and project. Inside the floating window, you can also switch the target workspace or project before sending.

After you submit, Meowbert Desktop jumps straight to the new task in the main window.

Command palette

The command palette is still the quickest way to move around once Meowbert Desktop is focused. Open it with its configured shortcut, then search for actions like:

  • All Projects
  • New Task
  • Files
  • Terminal
  • Upload Files
  • Reveal Project Folder
  • Quick Agent
  • Desktop Preferences
  • Desktop Server Profiles

Window navigation

Use the app menu for window-level navigation:

  • View → Back
  • View → Forward
  • View → Reload

Common shortcuts:

  • macOS: Cmd + [, Cmd + ], Cmd + R
  • Windows / Linux: Alt + Left, Alt + Right, Ctrl + R

Desktop notifications

Open Notifications in the sidebar, then enable desktop notifications.

Once enabled, Meowbert Desktop can show native notifications for:

  • scheduled or recurring task updates,
  • background task responses,
  • task events that arrive while you're elsewhere in the app.

Clicking a notification brings the app to the front and opens the related task.

Native file dialogs

Desktop file dialogs appear automatically in the places where you already work with files:

  • Task Composer / Task page / Quick Agent — click the attachment button to pick files from your computer.
  • Files page — click Upload to choose one or more files.
  • Downloads — downloading a file or artifact opens a native save dialog instead of a browser download tab.

Opening folders on your computer

If you're connected to a local Meowbert server running on the same machine, the desktop app can open folders directly in your file manager.

You can do that from:

  • Files → Open Folder
  • Task page → More actions → Open Task Folder
  • your configured Reveal Folder shortcut
  • the command palette action Reveal Project Folder

Note: Folder reveal only works in local desktop mode. If you're connected to a hosted server, those files live on the server, not on your Mac or PC.

External browser handoff

A few flows still open in your system browser by design — for example, some connector auth flows such as GitHub installation. After you finish that flow in the browser, return to Meowbert Desktop and continue where you left off.

  1. Open Quick Agent when you want to start something fast from anywhere.
  2. Use the command palette to jump around once Meowbert Desktop is frontmost.
  3. Customize the shortcuts you use most in Desktop Preferences.
  4. Use the attachment button or your configured upload shortcut to add files.
  5. Enable desktop notifications so you don't need to babysit long-running tasks.
  6. Use Open Folder when you want to inspect local files outside the app.