Kairo

Kairo is a calm, local-first AI assistant for getting through everyday work faster. It keeps useful context in optional persistent memory and can connect agents to information from tools and platforms you authorize.

Works with your subscriptions on Claude Code, Codex, Cursor, Grok Build, OpenCode, and Google Antigravity. If they're set up on your computer, Kairo can control them.

"Wait, what are you selling me?"

Nothing. Kairo exists to make capable local agents easier to use for practical daily work.

We wanted something performant, remote-ready, and truly open. If we ever go the wrong direction, we want you to have everything you need to fork and build the editor that you want.

Installation

[!WARNING] Kairo currently supports Codex, Claude, Cursor, Grok Build, OpenCode, and Antigravity. Install and authenticate at least one provider before use:

• Codex: install Codex CLI and run codex login
• Claude: install Claude Code and run claude auth login
• Cursor: install Cursor CLI and run agent login
• Grok Build: install Grok Build CLI and run grok login
• OpenCode: install OpenCode and run opencode auth login
• Antigravity: enable it in Settings, then use Install Antigravity and Sign in with Google. No CLI is required.

Command line

curl -fsSL https://kairo.codes/install.sh | sh

On Windows, in PowerShell:

irm https://kairo.codes/install.ps1 | iex

Then run kairo to start the server and open the local web app. kairo service install keeps it running in the background, kairo update moves to a newer release, and kairo --help has the full reference.

To try it once without installing, run npx kairo@latest instead.

Desktop app

Install the latest version of the desktop app from GitHub Releases, or from your favorite package registry:

Windows (winget)

winget install Kairo.Kairo

macOS (Homebrew)

brew install --cask kairo-code

Debian, Ubuntu (.deb)

Download the .deb from GitHub Releases, then:

sudo apt install ./Kairo-Code-*.deb

Arch Linux (AUR)

Stable:

yay -S kairo-bin

Nightly:

yay -S kairo-nightly-bin

The AUR packaging is maintained in this repository under packaging/aur.

Some notes

We are very early in this project. Expect bugs.

We are (mostly) not accepting contributions yet. Small fixes may be considered. Big features will not be.

Documentation

Full docs live in docs/. There's no docs site yet.

• Install and first run
• Build, Plan, and Study modes
• Persistent memory
• Scheduled tasks for students
• Permission modes
• Keyboard shortcuts
• Project settings
• Remote access from a phone or another machine
• Keeping app and server in sync
• Source control integrations
• Multiple accounts: Codex · Claude
• Linux: run Kairo as a background service
• Product development timeline

Building from source? Start at docs/internals/overview.md.

If you REALLY want to contribute still.... read this first

Install vp

Kairo uses Vite+ so you'll need to install the global vp command-line tool.

macOS / Linux

curl -fsSL https://vite.plus | bash

Windows

irm https://vite.plus/ps1 | iex

Checkout their getting started guide for more information: https://viteplus.dev/guide/

Install dependencies

vp i

Read CONTRIBUTING.md before reporting a bug or opening a PR.

Have a feature request? Start an Ideas discussion.

Need support? Join the Discord.