# Install KazoCode

> Install the KazoCode desktop app on Windows, macOS or Linux, what it needs to run, and how updates reach you.

KazoCode is a desktop app for Windows, macOS and Linux. It is built with Tauri, so it is small, starts fast and uses the system's own web view.

## Requirements

| System | Needs |
| --- | --- |
| Windows | Windows 10 or 11 with Microsoft Edge WebView2, which Windows 11 already includes |
| macOS | A recent version of macOS |
| Linux | WebKitGTK, which most desktop distributions include |

Some features use tools from your system when they're there:

- **Git** for Source Control, Bugbot reviews and agent worktrees.
- **The GitHub CLI** (`gh`) for pull request reviews and comments.
- **Language servers** for code intelligence. KazoCode finds them for you and offers to install a missing one. See [Language features](https://kazocode.app/docs/editor/languages.md).
- **SSH** for [remote projects](https://kazocode.app/docs/editor/remote.md).

## First launch

1. Run the installer for your system and open KazoCode.
2. Open a folder, or clone a repository.
3. Add a model in **Settings › Models**. See [Models and providers](https://kazocode.app/docs/agent/models.md).
4. Optionally [sign in](https://kazocode.app/docs/account.md) to sync your settings and keyboard shortcuts.

## Updates

KazoCode checks for updates 15 seconds after it starts and every six hours after that. When a new version is out, **Update** appears in the status bar; click it to get the new version.

## Where KazoCode keeps things

| What | Where |
| --- | --- |
| Your settings | `~/.kazocode/settings.json` |
| Global instructions for the agent | `~/.kazocode/KAZO.md` |
| Your skills, plugins and mods | `~/.kazocode/skills`, `~/.kazocode/plugins`, `~/.kazocode/mods` |
| Settings for one project | `.kazo/settings.json` in the project |
| Permission rules for one project | `.kazo/permissions.json` in the project |
