Kojo

kojo

[](https://github.com/loppo-llc/kojo/releases) [](go.mod) [](LICENSE)

[日本語](README.ja.md)

Remotely operate AI coding CLIs (Claude Code, Codex, Grok Build) from your mobile device — and run persistent AI agents, across one or more machines, that think, remember, and collaborate on their own.

┌───────────────────┐       Tailscale        ┌──────────────────┐
│  macOS / Win / Linux│◄─────(P2P encrypted)─────►│  Mobile Browser  │
│                     │                        │                  │
│  kojo server        │   WebSocket / HTTP     │  Web UI          │
│  ├─ PTY sessions    │◄─────────────────────►│  ├─ xterm.js     │
│  ├─ AI agents       │                        │  ├─ React        │
│  └─ credentials DB  │                        │  └─ Web Push     │
└───────────────────┘                        └──────────────────┘

Features

• Single binary — Built with Go, web UI embedded
• Cross-platform — macOS/Linux (tmux + PTY) and Windows (ConPTY) native support
• AI agents — Persistent AI personas with memory, scheduled execution, encrypted credentials, and group DM
• tmux-backed sessions (macOS/Linux) — CLI tools run inside tmux for crash resilience and persistence across kojo restarts
• Unified PTY — All CLIs handled uniformly via PTY. No SDK dependencies
• Tailscale P2P — No central server or database. Encrypted with WireGuard
• Zero config — Just run kojo with Tailscale running

Requirements

macOS / Linux

• Go 1.25+
• Node.js 20+
• tmux
• Tailscale
• Supported CLIs: claude, codex, grok (Grok Build) — at least one

Windows

• Go 1.25+
• Node.js 20+
• Windows 10 1809+ / Windows 11 (ConPTY support required)
• Tailscale
• Supported CLIs: claude,