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.
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:
This page cannot inspect the MCP connection in your application.
Manage accountFAQ & 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.