Kata Code

Kata Code is an "agent harness control surface". It enables control of the agents on your machine with a web app and an Electron desktop app.

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

Installation

Kata Code runs on macOS and Linux, and its mobile app runs on iOS. Windows and Android builds are paused; see supported platforms.

[!WARNING] Kata Code 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://raw.githubusercontent.com/gannonh/kata-code/main/scripts/install.sh | sh

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

To try it once without installing, run npx @kata-sh/code-cli@latest instead.

Desktop app

Download the desktop app from GitHub Releases, or run it from source with vp run dev:desktop.

Documentation

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

• Install and first run
• Permission modes
• Keyboard shortcuts
• Project settings
• Appearance preferences
• Remote access from a phone or another machine
• Keeping app and server in sync
• Source control integrations
• Multiple accounts: Codex · Claude
• Run Kata Code as a background service

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

Development

Install vp

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

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

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

Install dependencies

Secrets come from 1Password. See environment variables. Export OP_SERVICE_ACCOUNT_TOKEN, then:

vp i

Have a feature request? Open a GitHub issue on gannonh/kata-code.