R
rusty alpha
v0.1.0-alpha Portable Static Binary

Lightweight terminal coding agent built in Rust.

Statically compiled to run natively with zero dependencies. Rusty safeguards your development environment using local directory sandboxing, OS keychain integration, and absolute privacy. No runtime, no telemetry, no backdoors.

cargo build --release
Get Source Code on GitHub
Manifesto

Hardened local boundaries. Verified trust.

Most coding tools require bloated Node/Python packages, continuous background sync processes, and loose telemetry streams. Rusty operates under an absolute privacy model.

No Telemetry callbacks

Rusty features absolutely zero analytic instrumentation, tracing pipelines, or outbound metrics checks. Chat payloads transit strictly between your host and the verified LLM endpoint you configure.

Zero-Backdoor blueprints

Licensed entirely under AGPL-3.0-or-later copyleft protections. Every crate is distributed as open, verifiable source code. No compiled node packages, binary blobs, or obfuscated execution scripts.

Surgical path sandboxing

Every single file write, read, and edit is checked recursively. System structures, configurations, and parent directories (`~/.ssh`, `/etc`) are isolated and blocked before any agent action is allowed.

Native Keyring Secrets

Your API keys are stored in secure native hardware OS keychains (macOS Keychain, Linux Secret Service, Windows Credential Manager) instead of vulnerable plaintext `.env` configurations.

Quick Start

Up and running natively

Compile Rusty instantly, then launch a session. On first run, the interactive offline configuration guide secures your credentials, maps presets, and mounts directories immediately.

rusty --setup
Console Session
$ cargo build --release && ./target/release/rusty
// Environment audit complete. Launching Setup Wizard...
▲ Rusty Setup Wizard v0.1.0-alpha
Settings database `~/.rusty/settings.json` not found. Entering safe first-run sequence.
? Select LLM Provider Preset:
Xiaomi MiMo (token-plan-cn.xiaomimimo.com)
Kimi / Moonshot (api.moonshot.cn)
OpenAI (api.openai.com)
Ollama (localhost:11434)
DeepSeek (api.deepseek.com)
✓ Selected Preset: DeepSeek (deepseek-chat)
? Choose API Key Credential Store:
OS Keyring (Keychain / Credential Manager)
Settings File (~/.rusty/settings.json)
? Enter your API Key: ********************************
🔒 Securely stored API Key in OS Keyring.
✓ Configurations written to ~/.rusty/settings.json
🎉 Setup complete. Run `rusty` to start coding in plan, bypass, or default modes.
Offline Setup Pipeline Ready Active Target
Technical Audit

Performance and resource profile

Verified diagnostics derived directly from static compilation targets. Pure, zero-overhead execution metrics.

Binary footprint
~12 MB

Statically compiled inside Rust. Zero dynamically linked dependencies or bloated container nodes.

Startup overhead
< 15ms

Instant start latency. Avoids interpreters, background runtime boots, or virtual environment parsing.

macOS WindowServer CPU
~0.0%

Eliminates compositor overhead. Zero rendering lag even with multiple workspace sessions active.

Idle memory usage
~4.8 MB

Runs on ultra-low memory footprints. No background Node engines or Python runtime leakages.

Harness Architecture Comparison

Platform Profiles
Operational Aspect Rusty (Static Crate) Node/TS Harnesses Python Frameworks
Primary Dependency Statically linked bin Node runtime + 100MB+ node_modules Python + Pip packages dependency trees
Memory Footprint (Idle) ~4.8 MB ~60 MB - 120 MB ~45 MB - 90 MB
macOS WindowServer Load ~0.0% (99% Saved) 25% – 50% CPU spikes (2+ sessions) Variable (High on Tcl/Tk or Electron GUI)
API Key Encryption Native hardware keyring Plaintext environment logs Plaintext .env configs on host disks
Path Boundary Locks Strict workspace bounds Full parent disk access Arbitrary host access defaults
Third-Party Risk Statically audited crates Deep, shifting npm dependency trees Nested pip supply chain packages

The macOS WindowServer Composite Bottleneck

Modern web-tech developer tools offload code visualization and rendering loops to local Electron or Chrome layers, forcing macOS WindowServer processes to continuously recompute compositing arrays. Opening just two Node/TS agent sessions often captures up to 50% of system CPU purely to draw the interface.

Rusty is architected directly around a hardware-supported console-driven ioctl buffer pipeline. Because it writes raw terminal character arrays natively to the active shell viewport, WindowServer rendering overhead is reduced by **99%**, leaving absolute CPU power available for local compilations and model token operations.

Architecture

Workspace Map

Rusty contains no obfuscated packages. Review every single source directory, crate boundary, and utility module cleanly.

// crates/
├── core/
Foundation: config, permissions, OS credential store integrations, setup wizard.
├── provider/
Engine: OpenAI-compatible HTTP endpoints & SSE stream clients.
├── tools/
Sandboxes: file I/O operations, bash command evaluators, search & patch parsers.
├── agent/
Loop: core orchestration, sub-agents spawning, session compaction.
├── tui/
Viewports: low-latency, ratatui-based terminal system drawings.
└── cli/
Entry point: parameters bindings, parsing routines, run modes selector.
Operational Logic

Hardened Local Logic

Path Range Isolation

Before performing file operations or searches, Rusty verifies that targeted directories map cleanly underneath your current workspace context. Access beyond designated boundaries is aborted instantly.

Interactive Command Checks

Commands map recursively to offline classifications. Low-risk actions (such as checking `git status` or running `cargo test`) process smoothly, while modifications to workspace packages demand an explicit confirmation.

Open Copyleft Licensing

Every module operates transparently under copyleft AGPL-3.0-or-later conditions. No proprietary tracking middleware, background phone-homes, or telemetry is permitted in the compilation stream.

Privacy Guarantee

Zero Analytics Callbacks, Middleware, or Backdoors.

Rusty does not establish network handshakes to any central telemetry servers. The codebase contains no trackers, telemetry instrumentation libraries, or telemetry toggles. Requests stream strictly and directly between your terminal and the endpoint you specify.

Documentation Directory

CLI flags, tools, and custom interfaces

Inspect CLI parameters, sandbox agent capabilities, or TUI commands verified inside alpha builds.

Compilation & Deployment

Deploy Rusty locally

Secure binary builds directly on any architecture with normal Cargo toolchains.

1

Global Installation with Cargo

Standard Deployment

Download and assemble target sources from crates.io directly into standard cargo paths.

cargo install --path crates/cli
2

Build from local repository checkout

Perform a manual security audit of workspace source files, then assemble release binaries.

git clone https://github.com/PDG-Global/rusty.git
// Execute fully optimized local compiler build
cd rusty && cargo build --release
Content copied to clipboard