Skip to content

Install Volli

Install Volli on an Apple silicon Mac. Built-in chats use a model provider you connect.

Requirement Supported setup
Mac Apple silicon, M1 or later; no Intel build
macOS 13.0 Ventura or later
Git Installed, with a repository on disk
Model provider An account or API key for a provider available in Volli
  1. Download the .dmg from volli.app/download.
  2. Open the disk image and drag the Volli app to Applications.
  3. Open Volli from Applications.
  4. In Settings → All projects → Models, connect a provider and choose a default model. See Models and usage for more on providers and models.

Continue with Run your first coding task to add a repository, create a ticket, and review an agent’s change.

If the app will not open, note the exact message macOS shows and see Troubleshooting. Do not disable macOS security checks to get past a failure you cannot explain.

Settings → Updates shows your current version and has a Check now button. An available update downloads in the background and installs the next time you quit.

You can also download a release’s .dmg from GitHub Releases and replace the app in Applications.

Terminal companions you open from Volli have volli on PATH. In one of them, run volli identify to check its context. In Settings → All projects → About, expand Diagnostics to check and repair the parts of the installation that Volli owns. See CLI setup and context.

Volli stores app data under ~/Library/Application Support/Volli Code/ and ticket worktrees under ~/.volli/worktrees/. Removing a project from the app does not delete its repository folder.

See Local data and network access for what Volli stores and what it sends out, and Storage and backups before you delete app data.

  1. Quit Volli.
  2. Remove the worktrees you no longer need with Git. Follow Clean up worktrees before you delete a folder.
  3. Drag the Volli app from Applications to the Trash.

App data stays on disk. Deleting ~/Library/Application Support/Volli Code/ removes your local tickets, histories, and settings, so back it up first if you need them. Your project repositories stay where they are.

For development prerequisites and commands, see Build from source.