Installation
Verne is a native macOS application. Installing it takes a minute, and most of the setup happens on first launch.
Requirements
- macOS: a recent version is recommended.
- At least one CLI agent installed and on your
PATH, such as Claude Code (claude) or Codex (codex). Verne runs the agents you already use and does not bundle them. See Supported agents.
The app itself runs without any separate runtime or toolchain on your machine.
Download
Grab the latest build from the
GitHub releases page.
Both a .dmg installer and a .zip are published; either works.
Open the downloaded file, drag Verne into your Applications folder, and launch it. The builds are signed and notarized, so macOS opens them without a Gatekeeper warning.
The verne CLI
On first launch, Verne installs a small launcher at ~/.local/bin/verne. This
is the stable command that agents and integrations use to reach Verne. The
Verne MCP server, for example, registers as
verne mcp.
Put ~/.local/bin on your PATH so the command resolves in your shell and in
your agents. Shells that already pick up tools from nvm, pnpm, or Homebrew
usually include this directory. If verne isn’t found, add it:
$ export PATH="$HOME/.local/bin:$PATH"Add that line to your shell profile (~/.zshrc, ~/.bashrc) to make it
permanent.
Staying up to date
Verne checks for updates in the background. When a new version is ready it downloads on its own and shows a toast: first Downloading vX.Y.Z…, then Restart to Update. Click Restart to Update when it suits you, and Verne relaunches on the new version. You can also check from the Verne menu.
Next steps
Open a project and launch your first agent in Your first session.