rust-code

An AI-powered coding agent for the terminal, written in pure Rust.

Features

• Interactive REPL with streaming responses, markdown rendering, and syntax highlighting
• 23 built-in tools for file operations, shell commands, code search, web access, and more
• 26 slash commands for git, session management, diagnostics, and agent control
• Permission system with configurable rules (allow/deny/ask per tool and pattern)
• Agent loop that autonomously executes multi-step coding tasks with error recovery
• MCP support for connecting external tool servers (stdio + SSE transports)
• Memory system for persistent context across sessions (project + user level)
• Skills for custom reusable workflows loaded from markdown files
• Plugin system for bundling skills, hooks, and config as packages
• Session persistence with save, resume, and history
• Plan mode for safe read-only exploration before making changes
• Multi-agent coordination with typed agent definitions (general, explore, plan)
• IDE bridge protocol for VS Code and JetBrains integration
• Vi/Emacs editing modes with customizable keybindings

Architecture

┌───────────────────────────────────────────────────────┐
│               ENTRYPOINT (main.rs / cli)               │
│          CLI parsing, initialization, bootstrap        │
└─────────────────────────┬─────────────────────────────┘
                          │
┌─────────────────────────▼─────────────────────────────┐
│            CONFIG & BOOTSTRAP (config/)                 │
│      Settings loading, environment, MCP connect        │
└─────────────────────────┬─────────────────────────────┘
                          │
┌─────────────────────────▼─────────────────────────────┐
│             QUERY ENGINE (query/)                       │
│    Agent loop: compact → stream → tools → loop         │
└────────┬────────────┬──────────────┬──────────────────┘
         │            │              │
┌────────▼───┐  ┌─────▼─────┐  ┌────▼───────┐
│ TOOL LAYER │  │ PERMISSION │  │   HOOKS    │
│            │  │   SYSTEM   │  │            │
│ 23 tools   │  │ Rules      │  │ Pre/Post   │
│ MCP proxy  │  │ Plan mode  │  │ Shell/HTTP │
│ Executor   │  │ Ask/Deny   │  │ Lifecycle  │
└────────────┘  └────────────┘  └────────────┘
         │            │              │
┌────────▼────────────▼──────────────▼──────────────────┐
│                  SERVICES (12)                          │
│  LLM Client │ Compact │ MCP │ LSP │ Git │ Session     │
│  Tokens │ Bridge │ Coordinator │ Background │ Plugins  │
└───────────────────────────────────────────────────────┘

Quick Start

# Build
cargo build --release

# Set your API key
export RC_API_KEY="your-api-key"

# Run interactive mode
./target/release/rc

# One-shot mode
./target/release/rc --prompt "explain this codebase"

Configuration

Configuration is loaded from (highest to lowest priority):

1. CLI flags and environment variables
2. Project-local .rc/settings.toml
3. User config ~/.config/rust-code/config.toml

[api]
base_url = "https://api.anthropic.com/v1"
model = "claude-sonnet-4-20250514"

[permissions]
default_mode = "ask"

[[permissions.rules]]
tool = "Bash"
pattern = "git *"
action = "allow"

[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/path"]

[ui]
markdown = true
syntax_highlight = true

Tools

Commands

License

MIT