The desktop app gives you native notifications, a menu-bar agent list, and separate pane windows. Choose the download for your operating system and processor.
Desktop downloads for Vibeke 0.22.0:
| Operating system | Architecture | Download |
|---|---|---|
| macOS | Apple silicon (ARM64) | DMG · ZIP |
| macOS | Intel (x86_64) | DMG · ZIP |
| Linux | x86_64 / AMD64 | AppImage · DEB |
| Windows | x86_64 / AMD64 | EXE installer |
Linux ARM64 and Windows ARM64 desktop packages are not included in this release.
See installation for installation steps, signing details, and host requirements.
Connect to this computer
Local connections work on supported macOS and Linux hosts.
- Install the host CLI.
- Start
vibekein your project and keep the session running. - Open the desktop app.
- Select Connect to this Mac or Connect to this computer.
- If prompted, select Start gateway and retry the connection.
- Select Open Vibeke after the connection succeeds.
The app discovers the installed CLI and pairs over a private local socket.
If the CLI is not found, use Choose… to select the vibeke executable.
Connect to a remote host
Pair the app with the remote host through the public relay. The remote host needs no inbound port. See work on a remote machine for the steps.
Overview
Open Overview in the sidebar, or press Cmd+Shift+H (Ctrl+Shift+H on Windows and Linux).
It counts the agents that wait for you, the agents that work, and the work that is ready to review.
It lists open requests, and you can answer them there.
It also lists the agents that work now and recent activity.
Menu bar
The Vibeke icon stays in the menu bar (the system tray on Windows and Linux) while the app runs. On macOS, the icon gets a dot when an agent needs you. A number next to it shows how many agents need you. An agent needs you when it waits for an approval or an answer, or when it stops with an error. An agent that finished its work also counts until you open the list.
Click the icon to open the list. Open requests come first. You can answer them directly. Below them, the list shows every agent on every connected host, with its state and how long it has been in that state. Select an agent to open its pane in the main window. Set a keyboard shortcut for the list in the app settings.
Previews
A preview is a dev server that runs in a pane, for example a web app on port 3000.
Select the Previews button in the workspace header, or press Cmd+Shift+B (Ctrl+Shift+B on Windows and Linux).
The button shows how many previews are running.
The Previews tab of the right panel lists the previews of the workspace. Running previews come first. Previews that Vibeke found by itself are grey. Select Open to show one. Use the menu of a row to Forget a preview.
Select a preview to show the page in the panel. The agent stays visible beside it. Select Expand to show the page in the main area. Select Collapse to move it back to the panel. The page does not reload. The page runs through the host connection, so it also works for a remote host.
Select Annotate page above the page to leave notes for the agent. Click an element to pick it. Drag to pick an area. Write a note for each pick, then select Send to agent. See annotate a page for an agent.
Notifications and updates
Configure alerts in the app settings. Allow notifications when your operating system asks. The host and gateway must remain running to receive live requests.
Use Check for Updates… in the application menu or Settings → About. When a new release is available, a button above the sidebar footer opens its details and release notes. Choose Download update, then Restart and update when ready. The app restores your last view and encrypted unsent conversation drafts, then reconnects to your hosts.
Background checks run every six hours and can be turned off in the update settings. Downloading and restarting require an explicit action. Terminal composer text stays in memory and is not restored after restarting.
In-app installation supports Windows EXE, Linux AppImage, and properly signed and notarized Mac packages. Mac builds without publisher signing and Linux DEB installations show Download installer instead. Install that package using the usual OS installation steps. Users of v0.1.0 must manually install an update-enabled release once.
Desktop updates are separate from host CLI updates. Update each host from its terminal
interface or with vibeke update.
For host connection problems, run vibeke gateway status and vibeke doctor on the host.
Next steps
- Work on a remote machine: connect the app to a remote host.
- Phone and browser access: pair a phone.
- Previews and browsers: learn how previews and browser panes work.