Mitsuro

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

Overview

Krusty is a multi-platform AI coding assistant. The krusty binary bundles a terminal TUI, a web server with an embedded frontend, and editor integration via ACP. Autonomous Mako execution lives in the separately supervised krusty-mako daemon, so it survives client and HTTP-server restarts without creating a second execution owner. The frontend is built with Expo (React Native) and shared across mobile (iOS/Android), web (embedded in the server binary), and desktop (Tauri wrapper).

Repository Layout

crates/
  krusty-cli/     Terminal UI + CLI entry point (the main binary)
  krusty-core/    Shared AI, tools, storage, runtime (library)
  krusty-server/  API server with embedded web frontend (library)
apps/
  mobile/         Expo app — iOS, Android, and web (React Native)
  desktop/        Tauri desktop wrapper around the Expo web build
packages/
  api/            TypeScript API client (shared between mobile + desktop)
  state/          Zustand state management (shared between mobile + desktop)
  ui/             Design tokens and theme definitions (shared between mobile + desktop)
wit/              WebAssembly Interface Types for the extension system

Quick Start

Install

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

The installer requires the release archive checksum published alongside each GitHub release asset before it installs the binary.

Or from source:

sudo apt-get update
sudo apt-get install -y build-essential pkg-config libudev-dev
git clone https://github.com/honeycomb-Technologies/Krusty.git
cd Krusty
cargo build --release
./target/release/krusty

Commands

krusty serve bundles everything — API server, agent runtime, and the embedded Expo web build — 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.

If krusty serve reports Tailscale permission denied, run this once:

sudo tailscale set --operator=$USER

Supported Providers

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.

TUI Controls

Keyboard Shortcuts

Slash Commands

Mouse

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

Features

Multi-Provider AI

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

Tool Execution

• 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

Plan/Build Mode

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.

Terminal Integration

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

Context Compression

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

Skills

Agent Skills-compatible, progressively disclosed instruction sets. Krusty
discovers native, Agent Skills, Pi, OpenCode, Claude, Codex, project, and plugin
package roots with deterministic precedence and local allow/ask/deny policy.
Browse and manage them with /skills.

Plugins

Transactional plugin bundles can contribute TUI components, agent extensions,
skills, MCP configuration, hooks, and assets. Installs distinguish signed,
npm-unsigned, and local-unsigned trust; lifecycle scripts are off by default;
permissions, pinning, updates, reconciliation, and uninstall are explicit.
Manage them with /plugins.

Agent Extensions

Trusted local JavaScript/TypeScript workers can register tools, slash commands,
canonical lifecycle observers, persistent state, and bounded turn context.
Global, project, and permissioned package roots hot-reload with last-known-good
recovery.

Hooks

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

Permission Modes

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

Switch with /permissions.

Sessions

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

Themes

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.

Auto-Updates

Krusty checks for updates via /update. Windows can apply the standalone
binary update in place after verifying the release SHA-256 manifest.
Mako-bearing Unix releases distribute krusty, the supervised krusty-mako
daemon, and service units as one set, so Krusty fails closed instead of updating
only one binary. Use a Mako-capable package channel or the checksum-verifying
installer after that release is published; until then, build the complete set
from source.

Configuration

Data stored in ~/.krusty/:

~/.krusty/
├── credentials.json  # API keys (encrypted)
├── preferences.json  # Settings (theme, model, recent models)
├── extensions/       # Zed WASM plus executable agent extensions
├── plugins/          # Immutable package snapshots, lockfile, trust, grants
├── 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

Project Configuration

Add a 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.

Documentation

Detailed project documentation lives in docs/:

• Architecture - System overview, data flow, and design decisions
• Core Engine - Agent orchestrator, AI providers, tools, context management
• Storage - SQLite persistence layer
• Interfaces - TUI, web server/API, ACP editor integration, Mako autonomous mode
• Frontends - Mobile app (Expo), desktop app (Tauri), shared packages
• Extensions - Plugin packages, agent extensions, WASM, MCP, plans, and skills
• Operations - Build, CI/CD, packaging, and deployment

Tech Stack

Development

Rust backend

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

Expo frontend (mobile + web)

cd apps/mobile
bun install
bun run start              # dev server (all platforms)
bun run web                # web only
npx expo export --platform web  # production web build

Desktop (Tauri)

cd apps/desktop/shell
bun install
bun run dev                # Tauri dev with Expo web hot-reload
bun run build              # production build (DEB, RPM)

License

MIT License - see LICENSE for details.