Simplicio DOCS
Blog GitHub ↗

SIMPLICIO / Documentation & Architecture

High-Performance Native AI Coding Runtime

The official operational and architectural manual for Simplicio: 100% Rust single-binary execution, wave orchestration, mechanical edit guarantees, and MCP agent integration.

Documentation & Architecture

Built from the ground up in native Rust

Unlike heavy wrappers and Python scripts, Simplicio compiles down to a single self-contained binary. No virtual environments, no cold-start latency, and zero dependency conflicts on your host system.

Rust Tokio MCP SHA-256
Runtime Engine 100% Rust
Neural Cache Lookup: 177 ns Token Waste: 0 Tokens

Installation

One command to get started

Install the signed, standalone binary on your platform:

curl -fsSL https://simpleti.com.br/simplicio/install.sh | sh

Verifies the checksum and installs the executable for your platform.

Lifecycle

End-to-End Request Lifecycle

How Simplicio coordinates every user request from prompt ingestion to verified delivery:

1. MCP Protocol Ingestion

Your AI agent (Claude, Cursor, Antigravity, etc.) sends tool invocations via standard JSON-RPC 2.0 without leaving the chat.

2. CPUExecutor Lane Classification

Calls are categorized into InteractiveHigh for instant UI responses or AnalysisBackground for indexing. File mutations are strictly serialized to 1 write worker.

3. Neural Cache Lookup

Simplicio checks local SQLite FTS and embedding memory before inspecting disk files. Architectural decisions and previous context are retrieved in nanoseconds.

4. Bounded Context Slicing

Instead of dumping 5,000-line files, Simplicio calculates the exact token budget and yields a structural map with only relevant symbols.

5. Mechanical Edit & Hash Verification

Target blocks are replaced atomically with zero output token regeneration. SHA-256 pre-image and post-image hashes guarantee zero regression.

6. Delivery Barrier & Receipt Verification

Automated local checks run (linters, test suites). A verifiable execution receipt is returned to the agent confirming completion.

CPUExecutor

CPUExecutor & Concurrency Governance

Simplicio guarantees stability and eliminates race conditions through strict internal multi-lane governance:

Lane Priority Concurrency Operations
InteractiveHigh High CPU × 2 Your AI agent (Claude, Cursor, Antigravity, etc.) sends tool invocations via standard JSON-RPC 2.0 without leaving the chat.
AnalysisBackground Standard Tokio Semaphore Simplicio checks local SQLite FTS and embedding memory before inspecting disk files. Architectural decisions and previous context are retrieved in nanoseconds.
write_workers: 1 Serialized 1 Target blocks are replaced atomically with zero output token regeneration. SHA-256 pre-image and post-image hashes guarantee zero regression.

Mechanical Edits

Deterministic Mechanical Edit Engine

Standard LLM coding assistants rewrite entire files, burning thousands of output tokens and risking hallucinations. Simplicio enforces atomic mechanical edits:

Full-file generation

Standard LLM coding assistants rewrite entire files, burning thousands of output tokens and risking hallucinations. Simplicio enforces atomic mechanical edits:

Targeted mechanical edits

Target blocks are replaced atomically with zero output token regeneration. SHA-256 pre-image and post-image hashes guarantee zero regression.

// Simplicio
{
  "TargetFile": "/path/to/src/auth.rs",
  "TargetContent": "fn verify_token(token: &str) -> bool {\n    true\n}",
  "ReplacementContent": "fn verify_token(token: &str) -> bool {\n    validate_jwt_signature(token)\n}"
}

Agent Setup (MCP)

Agent Integration (MCP JSON)

Configure Simplicio in your favorite AI agent in less than 60 seconds:

Verify in your application

This page cannot inspect the MCP connection in your application.

Manage account
Try asking
Map the project architecture.
Apply a targeted edit and verify the result.
Run the project tests and show any failures.

FAQ & Privacy

Frequently Asked Questions & Boundaries

Is my source code sent to Simplicio servers?

No. Simplicio runs 100% locally on your machine as an MCP server. Your source code and edits never leave your machine unless your chosen model provider sends them over your configured LLM API.

What models are supported?

Simplicio is model-agnostic. It works seamlessly with Claude 3.7/Sonnet, GPT-4o, DeepSeek V3/V4, Gemini 2.0 Pro/Flash, Qwen 2.5, and local Ollama models.

How does Simplicio achieve up to 96% token savings?

By replacing repetitive full-file reads with bounded structural maps and eliminating whole-file generation in favor of targeted mechanical string replacements verified by SHA-256 hashes.