▄ •▄ ▄▄▄  ▄• ▄▌.▄▄ · ▄▄▄▄▄ ▄· ▄▌
█▌▄▌▪▀▄ █·█▪██▌▐█ ▀. •██  ▐█▪██▌
▐▀▀▄·▐▀▀▄ █▌▐█▌▄▀▀▀█▄ ▐█.▪▐█▌▐█▪
▐█.█▌▐█•█▌▐█▄█▌▐█▄▪▐█ ▐█▌· ▐█▀·.
·▀  ▀.▀  ▀ ▀▀▀  ▀▀▀▀  ▀▀▀   ▀ •

Krusty is a single binary that bundles a terminal TUI, a web server with an embedded PWA frontend, and editor integration via ACP — all in one.

crates/
  krusty-cli/     Terminal UI + CLI entry point
  krusty-core/    Shared AI, tools, storage, runtime
  krusty-server/  API server (library, embedded in CLI)
apps/
  pwa/            SvelteKit PWA frontend (embedded at compile time)
  desktop/        Tauri desktop wrapper

curl -fsSL https://raw.githubusercontent.com/honeycomb-Technologies/Krusty/main/install.sh | sh

Or from source:

git clone https://github.com/honeycomb-Technologies/Krusty.git
cd Krusty
cargo build --release
./target/release/krusty

krusty serve bundles everything — API server, agent runtime, and PWA frontend — into a single process. On first run it walks you through provider and API key setup. If Tailscale is installed, it auto-configures remote HTTPS access.

Configure providers via /auth in the TUI or on first run of krusty serve. Anthropic and OpenAI support OAuth browser login in addition to API keys.

Switch providers and models anytime with /model.

• Click and drag to select text
• Scroll wheel to navigate
• Click links to open in browser

Configure multiple providers and switch between them seamlessly. Your conversation continues even when switching models.

• Read/Write/Edit/MultiEdit - File operations with syntax highlighting
• Bash - Run shell commands with streaming output
• Glob/Grep/List - Search files and content (ripgrep-powered)
• Explore - Spawn parallel sub-agents for codebase analysis
• Build - Spawn parallel builder agents for complex operations
• Apply Patch - Multi-file patch application
• Ask User - Interactive prompts with multi-choice or custom input

Toggle between structured planning and execution modes with Ctrl+G:

• Plan Mode - Restricts write operations, focuses on task planning with phases and tasks
• Build Mode - Enables all tools for execution of approved plans

Plans are stored as markdown in ~/.krusty/plans/ and can be managed with /plan.

Open an interactive terminal session with /terminal for direct shell access within the TUI.

Use /pinch to compress long conversations into a new session with summarized context, preserving essential information while reducing token usage.

Modular instruction sets for domain-specific tasks. Add custom skills in ~/.krusty/skills/ or project .krusty/skills/. Browse with /skills.

Extensible plugin system with install, enable/disable, and reload support. Manage with /plugins.

Pre and post-tool execution hooks for custom workflows. Configure with /hooks.

• Supervised (default) - Requires approval for write operations
• Autonomous - Auto-executes all tools

Switch with /permissions.

All conversations are saved locally in SQLite. Resume any session with /load (filtered by current directory).

31 built-in themes including krusty (default), tokyo_night, dracula, catppuccin_mocha, gruvbox_dark, nord, one_dark, solarized_dark, synthwave_84, monokai, rosepine, and more. Switch with /theme.

Krusty checks for updates and can self-update via /update.

Data stored in ~/.krusty/:

~/.krusty/
├── credentials.json  # API keys (encrypted)
├── preferences.json  # Settings (theme, model, recent models)
├── extensions/       # Zed WASM LSP extensions
├── bin/              # Auto-downloaded LSP binaries
├── skills/           # Custom global skills
├── plans/            # Markdown plan files
├── tokens/           # LSP and MCP authentication
├── mcp_keys.json     # MCP server credentials
└── logs/             # Application logs

Add a KRAB.md or CLAUDE.md file to your project root for project-specific instructions that are automatically included in context. Generate one with /init.

Project-level skills in .krusty/skills/ override global skills.

cargo fmt --all
cargo clippy --workspace -- -D warnings
cargo build --workspace
cargo test --workspace

PWA frontend (requires bun):

cd apps/pwa/app
bun install
bun run check
bun run build

MIT License - see LICENSE for details.