◆ docs

Run Kuzy in 60 seconds.

Pick your platform, paste a one-liner, and you're running a native coding agent that reads your repo, drives your terminal, and ships work.

macOS Desktop

bash

git clone https://github.com/bulbulogludemir/kuzy.git
cd kuzy/desktop && npm install && npm run dev

macOS · Linux

bash

git clone https://github.com/bulbulogludemir/kuzy.git
cd kuzy && pip install -e .
./kuzy --cli

Source

bash

# Issues, discussions, and releases live on GitHub.
# Public binaries follow the public release.

◆ concepts

4 tiers: built-in soul, global, per-project, session. Plaintext markdown under ~/.henry, 0o600. Secrets routed through macOS Keychain.

Parallel workers with full tool access. 2–10 concurrent by plan. Each gets its own context window and exit code.

Python runs in a Docker container when available (no network, read-only fs, mem + cpu capped). Falls back to direct exec with a loud warning.

50+ built-in tools: shell, files, browser, web search, git, vision, chains, checkpoints, Telegram, WhatsApp, MCP bridge.

Playwright-driven headless Chromium. Search via Serper + Firecrawl. Vision analyzes pages. SSRF-blocked at the URL layer.

Hosted gateway routes via OpenRouter (30+ models). Or BYOK: OpenAI, Anthropic, Groq, Cerebras, OpenRouter, Ollama, LM Studio.

◆ your first task

Try it in 30 seconds.

Open a repo. Run this. Watch it work.

bash

cd ~/your-repo
kuzy "find any flaky tests in the last week, fix them, and open a PR"