Install Volli
Install Volli on an Apple silicon Mac. Built-in chats use a model provider you connect.
Requirements
Section titled “Requirements”| 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 |
Install the app
Section titled “Install the app”- Download the
.dmgfrom volli.app/download. - Open the disk image and drag the Volli app to Applications.
- Open Volli from Applications.
- 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.
Updates
Section titled “Updates”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.
The volli CLI
Section titled “The volli CLI”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.
Where your data lives
Section titled “Where your data lives”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.
Uninstall
Section titled “Uninstall”- Quit Volli.
- Remove the worktrees you no longer need with Git. Follow Clean up worktrees before you delete a folder.
- 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.
Build from source
Section titled “Build from source”For development prerequisites and commands, see Build from source.