Kraki docs

Chat with the coding agents on all your computers, from one app.

1. Install Kraki on your computer

Install Kraki on each computer whose agents you want to use. Your agents keep running there; Kraki connects them to your other devices.

Mac

Download Kraki for Mac (macOS 15 or later), drag it to Applications and open it. Setup has two steps: it checks the coding agents on your Mac and asks for Full Disk Access, then signs you in with GitHub. Kraki keeps running in the background and starts when you log in.

Windows (preview)

Download Kraki for Windows (Windows 10 or 11, x64) and run the installer. The preview installer isn't signed yet: if Windows says it protected your PC, choose More info, then Run anyway. Kraki for Windows doesn't update itself yet; download new versions from this page.

Linux, or the command line anywhere

# macOS / Linux
curl -fsSL https://app.kraki.chat/install.sh | bash

# Windows (PowerShell)
irm https://app.kraki.chat/install.ps1 | iex

# or with npm
npm i -g @kraki/tentacle
kraki

On first run Kraki checks your agents, signs you in with GitHub, starts in the background and shows a QR code for your phone. Run kraki agents any time to check your agents again. You need only one of Kraki for Mac and the command-line version on a computer; Kraki for Mac offers to take over an existing command-line install.

2. Add your phone (optional)

Scan the QR code Kraki shows on your computer, or sign in with the same GitHub account. Then you can follow sessions, approve tool calls, answer questions and send instructions from anywhere, with a notification when an agent needs you.

3. Supported agents

Kraki works with Claude Code, Codex, GitHub Copilot and Pi. Install and sign in to them as usual; Kraki finds them and uses any model they support. Each agent's own terms and pricing apply.

Every session has a mode: Safe asks before changes and commands, Auto runs tools without asking, Delegate also answers its own questions. New sessions start in Auto; choose the mode per session in the chat header.

4. Troubleshooting

5. Guides

6. Help