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 shortcut | Action |
|---|---|
Cmd/Ctrl + Shift + Space | Open Quick Agent from anywhere on your computer |
Cmd/Ctrl + K | Open the command palette |
Cmd/Ctrl + N | Start a new task in the current project |
Cmd/Ctrl + Shift + F | Open the Files page for the current project |
Cmd/Ctrl + Shift + T | Open the Terminal page for the current project |
Cmd/Ctrl + Shift + U | Open the native file picker |
Cmd/Ctrl + Shift + O | Open 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.
Recommended everyday workflow
- Open Quick Agent when you want to start something fast from anywhere.
- Use the command palette to jump around once Meowbert Desktop is frontmost.
- Customize the shortcuts you use most in Desktop Preferences.
- Use the attachment button or your configured upload shortcut to add files.
- Enable desktop notifications so you don't need to babysit long-running tasks.
- Use Open Folder when you want to inspect local files outside the app.