# Volli Code

> Documentation for Volli Code, a macOS app that plans work on a kanban board and runs coding agents in isolated git worktrees.

## Get started

- [Install Volli Code](https://docs.volli.app/start/install.md): Install Volli Code for macOS, install a coding agent for it to run, and set up the volli command.
- [Quickstart](https://docs.volli.app/start/quickstart.md): Add a project, write a ticket, and hand it to a coding agent running in its own git worktree.
- [Concepts](https://docs.volli.app/start/concepts.md): The vocabulary Volli uses for tickets, sessions, worktrees, and the records it keeps.

## Using Volli

- [The board](https://docs.volli.app/guides/board.md): What each of Volli's five columns means, what moves tickets between them, and how manual moves interact with agent activity.
- [The ticket workspace](https://docs.volli.app/guides/ticket-workspace.md): How the rail, tabs, files, and change set work once you open a ticket, and how to read and edit its properties.
- [Agents and worktrees](https://docs.volli.app/guides/agents-and-worktrees.md): How Volli isolates each ticket in its own git worktree, which coding agents it supports, and how sessions behave.
- [Settings and configuration](https://docs.volli.app/guides/settings.md): Every pane in Settings and Configure, including the worktree copy set that controls which local files reach a fresh ticket, and how to back up your data.
- [Theming](https://docs.volli.app/guides/theming.md): Change Volli's colors globally or per project, build a theme from any seed color, and understand what the terminal does.

## Reference

- [CLI reference](https://docs.volli.app/reference/cli.md): Every volli command, its flags, and the environment it reads, for you at a terminal and for the agents Volli runs.
- [Keyboard shortcuts](https://docs.volli.app/reference/keyboard-shortcuts.md): Every keyboard shortcut in Volli Code, grouped by where it applies.
- [Troubleshooting](https://docs.volli.app/reference/troubleshooting.md): Fixes for CLI connection failures, native module errors, agents that won't start, and questions about where Volli keeps your data.