SPAVN v0.2.0 · 3.8 MB Native Rust Binary · Autonomous Harness Intelligence · Zero Vendor Lock-In

Autonomous Terminal Engineering.
Sub-Millisecond Rust Precision.

SPAVN is a sovereign, model-agnostic terminal coding agent built in pure Rust (rustls). Connect your own local Apple Silicon / CUDA GPU cluster (llama-swap, llama.cpp, Ollama) or bring your own API keys—paired with a Zero-Stop Compiler Gate, Fuzzy Self-Heal Edits, Stale-File Guard, and a zero-flicker TUI.

macOS (ARM64 / Intel) · Linux

$curl -fsSL https://spavn.dev/install.sh | sh

0.8ms

Cold Startup Time (vs ~480ms Node CLI)

3.8MB

Statically Linked Native Binary (lto=thin)

3–4×

Faster Coding via Parallel Pre-Flight Tools

100%

Flicker-Free DEC Mode ?2026h Synced TUI

Pinned bottom dock stays anchored during live thinking & tool execution — featuring atomic iTerm2 vision pills ([🖼️ ...]), inline queued message previews (📥 #1), and Shift+←/→ visual selection.

Engine Architecture

Engineered to Outperform Every Scripting Harness.

Every subsystem in SPAVN is written from scratch in Rust—eliminating garbage collection pauses, terminal scrollback corruption, and vendor lock-in.

Synchronized Pinned Dock & Atomic Vision Pills

Wrapped in DEC ?2026h synchronized frame batches. Drop any screenshot into your terminal: SPAVN renders an inline iTerm2 preview (OSC 1337) and collapses the path into an atomic [🖼️ arch.png (184KB)] token that skips or deletes with a single Backspace.

╭─ 🔥 SOVEREIGN · 💻 CODE · 🟢 qwen3.6-35b-a3b-mtp │ ⠹ Thinking (1.8s)
│ 📥 #1: Queued · run cargo clippy and push to main [↑: Edit · Ctrl+X: Cancel]
│ ❯ [🖼️ Screenshot.png (235KB)] fix layout shift█

Local GPU (`llama-swap`) + Model-Agnostic BYOK

Zero subscriptions or middleman markup. Auto-discovers local llama.cpp / llama-swap / Ollama / LM Studio endpoints alongside your own OpenAI-compatible or custom gateway keys—with automatic 1.5s local warm-up retry.

🟢 qwen3.6-35b-a3b-mtp 58.4 tok/s · Local M3 Max
🟢 deepseek-r1-distill 74.1 tok/s · Local GPU Node
🔑 custom-byok-gateway 1M+ ctx · Direct Wire SSE

Budget-Relative `/compact` & Prune

Scales compaction budgets dynamically to the active model's window (32K local up to 1M+ windows), replaces duplicate file reads with [superseded by later read], and preserves architectural state.

╭─ 🗜️ Budget-Relative Compactor
148.2k → 11.4k tok · supersede_prune

Zero-Stop Compiler Gate & Arity Map

Runs cargo check / tsc --noEmit / py_compile / go vet automatically after edits, and injects live function/struct signatures ([SPAVN LIVE PROJECT SIGNATURES]) to prevent parameter hallucinations.

⚡ Zero-Stop Gate + Live Signatures:
✔ cargo check · arity_map · 0 errors

Fuzzy Self-Heal `edit` & Stale Guard

Recovers from whitespace/indentation drift, auto-expands off-by-N line ranges (±25 lines), enforces FS_STALE_VERSION mtime checks on disk, and snapshots every write for instant /undo [N] rollback.

✔ fuzzy_self_heal · FS_STALE_VERSION · /undo

Canonical Repeat-Tool Breaker

Recursively canonicalizes JSON tool arguments (regardless of key ordering) and injects a transparent [SPAVN REPEAT-TOOL BREAKER] intervention after 2 identical calls to eliminate infinite loops.

⚡ Repeat-Tool Breaker:
canonical_args · turn_schema_trim

Headless JSON-RPC 2.0 (`--rpc`)

Launch spavn --rpc to expose an NDJSON stdio server supporting prompt, abort, set_phase, set_model, and live token/tool streaming for spavn-desktop and IDEs.

{"jsonrpc":"2.0","method":"prompt"}
→ event: text_delta · tool_end · done

Symmetric SSH Fleet Radar

Prefix any file path or shell command with host:/path (e.g., m3:/opt/app or prod:/etc/nginx). SPAVN edits, searches, and verifies remote servers over SSH Multiplexing (ControlMaster) with zero agent installation.

● local · ● m3-gpu · ● telya-prod

1-to-1 Terminal Ergonomics

Every Action Mapped to One Intuitive Key.

Identical behavior whether the agent is idle or actively streaming code (Queue / Steer intervention bar).

Visual Text Selection

Highlight & delete any span with Backspace

Shift + ← / →

Instant Clear Input

Wipe long multiline input in one keystroke

Esc

Delete Word / Image Pill

Atomically remove words or [🖼️ ...] pills

⌥ Option + Backspace

Edit Queued Message

Pop last queued prompt back into editor

↑ Up Arrow

Toggle Steer vs. Queue

Switch live interrupt vs. next-turn queue

Tab

Cycle Sovereignty Mode

Switch SAFE → AUTO → 🔥 SOVEREIGN

Shift + Tab

Head-to-Head

How SPAVN Compares to the Field.

Honest engineering comparison against leading terminal coding harnesses.

Capability	⚡ SPAVN v0.2.0	Oh-My-Pi (OMP)	Claude Code	OpenAI Codex CLI
Runtime & Footprint	Native Rust (3.8 MB)	Node.js / TS (~85 MB)	Node.js Bundle (~110 MB)	Rust / Hybrid
Cold Startup Latency	0.8 ms	~320 ms	~480 ms	~15 ms
Local GPU (`llama-swap` / GGUF)	✔ First-Class + Auto-Retry	✔ Custom Providers	✖ Anthropic Cloud Only	◑ Basic OSS Flag
Inline Queued Message Preview & Edit	✔ Live `#1` Row + `↑` Edit	✔ Steer / Follow-up	◑ Queue Only	✖ Blocking Input
Visual Text Selection (`Shift+←/→`)	✔ Idle & Busy Parity	✔ TUI Editor	✖ Basic Readline	✖ Basic Readline
Symmetric Remote SSH (`host:/path`)	✔ Native Multiplexed Fleet	✖ Local Shell Only	✖ Local Shell Only	✖ Local Shell Only
Context Compaction (`/compact`)	✔ Budget-Relative + Supersede Prune	✔ LLM Summarization	✔ LLM Summarization	◑ Truncation
Zero-Stop Compiler Gate & Stale-File Guard	✔ Built-in (`FS_STALE_VERSION` + Arity Map)	◑ Optional Hook	◑ Basic Read Check	✖ None
Fuzzy Self-Heal `edit` & Multi-Step `/undo`	✔ Whitespace Heal + ±25L Expand + `/undo [N]`	◑ Exact Match	◑ Exact Match	◑ Patch Only
Canonical Repeat-Tool Loop Breaker	✔ Sorted-JSON Detection + Auto-Hint	✖ None	✖ None	✖ None
Headless Desktop/IDE Bridge (`--rpc`)	✔ Native JSON-RPC 2.0 Stdio	✔ RPC Mode	◑ SDK Only	✖ None

Method. SPAVN figures are self-measured on an Apple M3 (macOS 15, warm page cache, hyperfine --warmup 20 over 100 runs). Competitor figures are published package sizes and a comparable-host cold-start run recorded on 4 Nov 2026 — indicative, not a controlled cross-machine benchmark. Measure your own stack before switching.

Autonomous Terminal Engineering. Sub-Millisecond Rust Precision.