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)
- iPhone: the native app is in beta on TestFlight.
- Any phone or browser: open app.kraki.chat. On a phone, use Add to Home Screen for full-screen use and push notifications.
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
- An agent doesn't show up: make sure it's installed and signed in on that computer, then run
kraki agents(or reopen setup in Kraki for Mac/Windows). - Mac: an agent can't read your projects: give Kraki Full Disk Access in System Settings → Privacy & Security.
- A computer shows as offline: it has to be awake and online; Kraki catches up by itself when it reconnects.
- Reporting a problem: include your app versions from Settings → About. In the web app and Kraki for Windows, Copy Diagnostics copies them for you; remove computer names you don't want public.
5. Guides
- Security model: what is end-to-end encrypted and what isn't.
- Run your own relay
- How Kraki works
6. Help
- Questions and ideas: GitHub Discussions
- Bugs: GitHub Issues (please don't post secrets)
- Security issues: report privately
- Email: corelli@corelli.cloud