⚡ Simplicio

The High-Performance Native AI Coding Runtime & Agent (100% Rust)
Save up to 96% of tokens with sub-millisecond local orientation, atomic edits, and governed concurrency.

Quick Install • First 60 Seconds • MCP & IDEs • Architecture • Full Documentation

---

⚡ What is Simplicio?

Simplicio is a single-binary, local-first runtime and AI coding agent built in 100% Rust. It replaces heavy context dumps and fragmented Python tools with mathematical token bounding, cryptographic atomic edits, and hardware-governed multi-agent orchestration.

• 100% Native Rust: Single ~46MB standalone binary. No Python, virtualenvs, or heavy background processes.
• Ultra-Low Latency: ~4ms cold start vs. seconds in interpreted runtimes.
• Token Economy: Saves up to 96% of tokens by projecting bounded AST graphs instead of dumping raw file trees.
• Fail-Closed Safety: Every code modification uses SHA-256 pre-image checks, atomic replacements, and immutable audit receipts.

---

📦 Quick Install

Install the signed native binary in seconds:

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/wesleysimplicio/simplicio/master/install.sh | sh

Windows (PowerShell as Administrator)

irm https://raw.githubusercontent.com/wesleysimplicio/simplicio/master/install.ps1 | iex

Alternative (PyPI Bootstrapper)

On Windows, use py -m pip install --upgrade simplicio-installer followed by simplicio install.

python3 -m pip install --upgrade simplicio-installer
simplicio install

---

🚀 First 60 Seconds

Once installed, test the CLI and orient your project:

# 1. Verify your installation
simplicio version

# 2. Orient and index your current repository
cd my-project
simplicio onboard

# 3. Launch the interactive coding assistant
simplicio

---

🔌 MCP & IDE Integration

Simplicio runs as an official Model Context Protocol (MCP) server for your favorite editors:

# Automatically configure Claude Code, Cursor, VS Code, Zed, and JetBrains:
simplicio mcp register

Manual MCP Server Configuration (stdio)

{
  "mcpServers": {
    "simplicio": {
      "command": "/absolute/path/to/.simplicio/bin/simplicio",
      "args": ["serve", "--mcp", "--stdio"]
    }
  }
}

For Codex, use an absolute executable path in your TOML configuration and replace the example username:

[mcp_servers.simplicio]
# Windows:
command = "C:/Users/YourName/.simplicio/bin/simplicio.exe"
args = ["serve", "--mcp", "--stdio"]

On macOS, replace the command line with:

command = "/Users/your-name/.simplicio/bin/simplicio"

On Linux, replace it with:

command = "/home/your-name/.simplicio/bin/simplicio"

See MCP-CONNECT.md for complete platform examples.

Exposed MCP Tools:

• simplicio_map: Structural repository orientation without prompt bloating.
• simplicio_context: Bounded token retrieval for exact code snippets.
• simplicio_edit: Atomic mechanical modifications with SHA-256 receipts.
• simplicio_loop: Concurrently orchestrated multi-stage waves.
• simplicio_parallel: Real-time inspection of CPUExecutor and hardware headroom.

---

⚙️ Core Architecture Highlights

User Prompt ──► simplicio map ──► simplicio context ──► Wave Loop ──► simplicio edit ──► Validate & Deliver
                 (Graph & AST)     (Token Bounding)     (Tokio DAG)   (Atomic SHA-256)   (Audit Receipts)

1. Orientation (simplicio map): High-speed discovery of import topologies and public interfaces without reading thousands of redundant files into LLM context.
2. Context Bounding (simplicio context): Mathematical budget packing (st_prompt_budget) ensuring the model only receives the exact AST fragments it needs.
3. Mechanical Edits (simplicio edit): Deterministic exact search/replace, insertions, and deletions with pre-image hashing. If the file changed underneath, the patch safely aborts (fail-closed).
4. Wave Orchestrator (simplicio loop): Multi-stage DAG partitioner executing parallel reads and commands through Tokio semaphores with deterministic state reduction.
5. Hardware Governor (CPUExecutor): Dynamically samples CPU and memory pressure to prevent machine lockups. Automatically throttles subagents while keeping writes strictly serialized (write_workers: 1).

---

📖 Complete Documentation & Guides

For deep technical dives, CLI references, benchmark proofs, and multi-agent workflows, visit our official documentation hub:

👉 https://simpleti.com.br/simplicio/docs

---

🔒 Security & Privacy

• Your Code Never Leaves Your Machine: All repository mapping, context packaging, editing, and test gates execute locally.
• Auditable Provenance: Every modification generates an immutable cryptographic receipt (receipt.json).
• No Mystery Telemetry: Zero silent telemetry or code exfiltration.

---

💬 Community & Support

• Official Website: simpleti.com.br/simplicio
• Documentation: simpleti.com.br/simplicio/docs
• Discord: Join the Community
• Issues: GitHub Issue Tracker

---

_{© 2026 SimpleTI. Simplicio is a registered proprietary software. All rights reserved.}