---
title: "Sila (صِلَة): Cross-harness continuity and alignment substrate for
  autonomous AI coding agents by Jad Madi (@jadmadi)"
description: Local-first continuity and governance substrate for autonomous AI
  coding agents. Consolidates multi-harness session memory across 10+ AI CLI
  tools into a queryable pure-Go SQLite store, compiles rulebooks, orchestrates
  pre-commit discipline gates, governs project skill exposure, reclaims disk
  bloat across 9 toolchains, and exposes a comprehensive 67-tool Model Context
  Protocol (MCP) server.
href: /project/sila/
author: Jad Madi
---

# Sila (صِلَة): Cross-harness continuity and alignment substrate for autonomous AI coding agents

Local-first continuity and governance substrate for autonomous AI coding agents. Consolidates multi-harness session memory across 10+ AI CLI tools into a queryable pure-Go SQLite store, compiles rulebooks, orchestrates pre-commit discipline gates, governs project skill exposure, reclaims disk bloat across 9 toolchains, and exposes a comprehensive 67-tool Model Context Protocol (MCP) server.

- **Website**: https://jadmadi.net/project/sila/
- **Official Site**: https://sila.jadmadi.net
- **Repository**: https://github.com/jadmadi/sila
- **Documentation**: https://github.com/jadmadi/sila/blob/main/README.md
- **License**: MIT (Core Engine) / Proprietary (Research & Edge Extensions)
- **Version**: v0.18.0
- **Status**: Active Development / Private Preview

## Quickstart & Installation

### Linux & macOS

```bash
curl -fsSL https://sila.jadmadi.net/sila/install.sh | sh
```

### Windows (PowerShell)

```powershell
irm https://sila.jadmadi.net/sila/install.ps1 | iex
```

### Build from Source (Go 1.26+)

```bash
go install github.com/jadmadi/sila/cmd/sila@latest
```

## The Problem: The AI Agent Amnesia Crisis

Autonomous coding agents operate in ephemeral, amnesiac silos: architectural decisions, debugging lessons, and institutional directives evaporate between sessions or when switching harnesses (Claude Code, OpenCode, Codex, Antigravity, Devin). Furthermore, uncontrolled global skill bloat injects tens of thousands of redundant tokens into agent prompts, triggering silent harness truncation and semantic confusion.

## The Solution: Unbroken Continuity

A local-first, zero-telemetry continuity engine and governance substrate that ingests multi-harness transcripts in milliseconds, compiles canonical rulebooks, coordinates epistemic roadmap goals and pre-commit discipline gates, enforces project-scoped skill governance with visual diff collision detection, reclaims developer disk space with a universal multi-toolchain cleaner, and equips agents with 67 native MCP tools and dynamic plugin bridging.

## Core Subsystems

### Multi-Harness Ingest Engine (10+ AI Loaders)

Non-destructive, read-only session parsers reading local JSONL and SQLite session logs in sub-10ms without modifying harness files.

- Zero-lock read-only inspection (mode=ro)
- Transcribes conversation turns, user intents, and tool outcomes
- Unified message normalization across disparate formats

### Dream & Epistemic Distillation (SQLite FTS5)

Background refinement furnace filtering chat chatter into physical disk-grounded facts, eliminating hallucinations.

- Physical disk file verification against source code
- Automated drift detection and lesson categorization
- Sub-millisecond BM25 full-text indexing via FTS5

### Dynamic Skill Governor (99.1% Bloat Slashed)

Progressive disclosure lens replacing 100k token prompt floods with surgical 2-3 micro-skill injection on-demand.

- Eliminates silent 50-skill prompt truncation traps
- LCS visual diff collision diagnostics across duplicate tools
- Sub-3ms on-demand retrieval via native MCP protocol

### Epistemic 4-Pillars Stage-Gate (Closed-Loop Contracts)

Structured roadmap goal packages bound by scope, plan, and invariant facts with advisory locks for multi-agent concurrency.

- Immutable goal triad: goal.md, plan.md, facts.md
- Atomic worktree lock leases preventing multi-agent collisions
- Pre-commit gatekeeper auditing tests, formatting, and changelogs

### Universal Multi-Toolchain Cleaner (9 Ecosystems)

Reclaims tens of gigabytes of developer disk bloat across Go, Rust, pnpm, aube, npm, uv, bun, zig, and mise.

- Strict path traversal verification and sandbox guards
- Prunes orphaned MCP caches and temporary test isolates
- Dry-run byte accounting before executing safe deletions

### Standalone Go Plugins Subsystem (Plugin Spec v1.0.0)

Dynamic MCP tool provider allowing developers to compile and link custom Go plugins directly into Sila.

- Pure Go plugin lifecycle management (sila plugins)
- Dynamic bridging into native MCP tool manifests
- Zero external CGO dependencies

## Graphic Facilitation Visual Series

Sila architecture and workflows are visual harvested across an 8-chapter graphic facilitation sketchnote series:

### Executive Overview: The Master Continuity Panorama

![The Master Continuity Panorama](https://jadmadi.net/media/sila/00-master-panorama.webp)

The panoramic ecosystem whiteboard capturing the full journey from the Amnesia Void across the Bridge of Sila into Grounded Collective Intelligence.

**Key Takeaways:**

- Depicts the transition from chaotic token incineration to unbroken memory continuity.
- Shows how Devin, Claude Code, Cursor, Antigravity, and OpenCode coordinate around sila.db.
- Anchors all workflows in the Data Sovereignty Covenant: 100% on-premise local custody.

**Related Commands:** `sila salam`, `sila prime`, `sila live`

### Chapter 1: Why Sila? The AI Agent Amnesia Crisis vs Continuous Memory

![Why Sila? The AI Agent Amnesia Crisis vs Continuous Memory](https://jadmadi.net/media/sila/01-amnesia-crisis.webp)

Contrasting the painful Groundhog Day memory wipe, redundant token incineration, and developer frustration with Sila unbroken continuity anchored on local SQLite (sila.db).

**Key Takeaways:**

- Without Sila: Every session restart wipes memory, repeating past bugs and burning tokens.
- With Sila: Unbroken continuity keeps past architectural directives and verified facts active.
- Initial prime takes under 3ms, retrieving context from local pure-Go SQLite.

**Related Commands:** `sila prime`, `sila recall "<query>"`

### Chapter 2: Sila Architecture: The 6 Core Subsystems & 67 MCP Tools

![Sila Architecture: The 6 Core Subsystems & 67 MCP Tools](https://jadmadi.net/media/sila/02-architecture-blueprint.webp)

An illustrated blueprint of Sila engine rooms surrounding the Pure Go 1.26+ single binary: Ingest, Dream & Distillation, Skill Governor, Goals & Worktrees, Epistemic Gate, and Edge MCP Server.

**Key Takeaways:**

- Single standalone static binary with zero external runtime dependencies.
- Houses 6 core modular engines executing locally with zero telemetry.
- Exposes 67 native Model Context Protocol tools to any compliant agent.

**Related Commands:** `sila --help`, `sila stats`, `sila doctor`

### Chapter 3: A Day in the Life with Sila: From Morning Priming to Nightly Dream

![A Day in the Life with Sila: From Morning Priming to Nightly Dream](https://jadmadi.net/media/sila/03-dev-journey.webp)

The five daily developer milestones: 09:00 AM Instant Priming (3ms), 11:00 AM Isolated Worktrees, 02:00 PM Multi-Tool Handoffs, 05:00 PM The Epistemic Gate, and 11:00 PM Nightly Drift Reconciliation.

**Key Takeaways:**

- Morning Standup: sila prime injects active project context in under 3 milliseconds.
- Midday Handoff: Seamlessly transition from terminal CLI to IDE without context decay.
- Evening Discipline: The Epistemic Gate enforces passing tests before code merges.

**Related Commands:** `sila prime`, `sila goals claim <slug>`, `sila handoff`, `sila gate`

### Chapter 4: Sila Dream: The Epistemic Distillation Engine

![Sila Dream: The Epistemic Distillation Engine](https://jadmadi.net/media/sila/04-dream-distillation.webp)

How raw conversation transcripts pass through the refinement furnace, getting checked against physical disk files to eliminate hallucinations while distilling verified facts into SQLite FTS5.

**Key Takeaways:**

- Centrifugal File Grounding: Claims in session chats are audited against actual disk files.
- Hallucination Purge: Unverified claims and disproven hypotheses are discarded.
- Grounded Truth: Distilled lessons and directives are indexed in SQLite FTS5.

**Related Commands:** `sila memo "<directive>"`, `sila lesson "<symptom>" --cause=... --fix=...`

### Chapter 5: Sila Skill Governor: Slashing 99% Context Bloat

![Sila Skill Governor: Slashing 99% Context Bloat](https://jadmadi.net/media/sila/05-skill-governor.webp)

How Sila precision optical lens solves prompt bloat, transitioning from crushing 100k token payloads to progressive disclosure: injecting only the exact 2-3 required micro-skills on-demand.

**Key Takeaways:**

- The Context Trap: Injecting 50+ global skills consumes 30k to 100k tokens per prompt.
- Optical Filter: Sila evaluates project tech stack and query intent in milliseconds.
- Progressive Disclosure: Injects only the precise micro-skills needed for the immediate step.

**Related Commands:** `sila skill search`, `sila skill load <id>`, `sila audit-hygiene`

### Chapter 6: Sila Goals & The Gate: Closed-Loop Contracts & Engineering Discipline

![Sila Goals & The Gate: Closed-Loop Contracts & Engineering Discipline](https://jadmadi.net/media/sila/06-goals-gate.webp)

The immutable triad contract (goal.md, plan.md, facts.md), multi-agent concurrency with advisory locks, and the impenetrable pre-commit Gatekeeper Shield.

**Key Takeaways:**

- Immutable Triad: Goals are bound by clear scope, sequential plan, and ground facts.
- Advisory Lock Tokens: Prevents parallel agents from overwriting the same files simultaneously.
- Gatekeeper Shield: Blocks commits unless tests, formatting, and changelog gates pass 100%.

**Related Commands:** `sila goals claim <slug>`, `sila gate check`, `sila goals audit <slug>`

### Chapter 7: Universal Cross-Harness Continuity & Multi-Agent Kinship

![Universal Cross-Harness Continuity & Multi-Agent Kinship](https://jadmadi.net/media/sila/07-multiagent-swarm.webp)

The collaborative round table of Sila: Devin, Claude Code, Cursor, Antigravity, OpenCode, and Cline passing standardized handoffs around the local 67-tool MCP vault.

**Key Takeaways:**

- The Round Table: Unites closed and open-source harnesses under one shared memory model.
- Standardized Handoffs: One agent writes lessons and directives; another picks them up seamlessly.
- Zero Vendor Lock-In: Freely switch AI models without abandoning project history.

**Related Commands:** `sila handoff "<summary>"`, `sila pop-handoff`, `sila sync-rules`

### Chapter 8: The Data Sovereignty Covenant: 100% Local Custody & Zero Ambient Telemetry

![The Data Sovereignty Covenant: 100% Local Custody & Zero Ambient Telemetry](https://jadmadi.net/media/sila/08-data-sovereignty.webp)

The four sacred pillars of Sila: Local Custody (no wires leaving premises), Zero Ambient Telemetry (zero tracking pings), Pure Go 1.26+ (Zero CGO), and complete Data Portability.

**Key Takeaways:**

- Local Custody: All memory resides in ~/.local/share/sila/sila.db on your hardware.
- Zero Ambient Telemetry: No background beacons, no analytics pings, no surveillance.
- Pure Data Portability: Standard SQLite schema with direct export to JSON and Markdown.

**Related Commands:** `sila doctor --covenant`, `sila clean --dry-run`, `sila vacuum`

## Common CLI Invocations

| Command | Description | Category |
| :--- | :--- | :--- |
| `sila salam` | Interactive status briefing and next step recommendations | core |
| `sila prime` | Loads active project facts, open goals, and directives in <3ms | memory |
| `sila recall "<query>"` | Sub-millisecond BM25 retrieval over distilled memory and lessons | memory |
| `sila goals ready` | Inspects unblocked roadmap goals ready to claim | governance |
| `sila goals claim <slug>` | Acquires advisory lock on a goal package and target files | governance |
| `sila gate check` | Runs pre-commit discipline sentries (tests, format, changelog, rules) | governance |
| `sila handoff "<note>"` | Creates cross-harness handoff checkpoint for another agent | core |
| `sila clean --dry-run` | Scans 9 developer toolchains for safe disk bloat reclamation | hygiene |
| `sila doctor` | Audits local environment health, SQLite mmap, and covenant compliance | core |

## Frequently Asked Questions

### How do I install Sila on Linux, macOS, or Windows?

On Linux and macOS, run `curl -fsSL https://sila.jadmadi.net/sila/install.sh | sh`. On Windows (PowerShell), run `irm https://sila.jadmadi.net/sila/install.ps1 | iex`. Both installers verify SHA-256 binary checksums from Cloudflare R2 and place the single static binary into your local PATH.

### What AI coding tools and harnesses does Sila support?

Sila includes non-destructive, read-only session loaders for 10+ AI CLI tools including Claude Code, OpenCode, Codex, Antigravity/Agy, Devin, Cursor, and git, exposing a 67-tool MCP server compatible with any standard MCP client.

### What is the Graphic Facilitation series?

The Graphic Facilitation series is an 8-chapter visual harvesting story illustrating the core architecture, workflow, and feature deep-dives of Sila, from the initial AI agent amnesia crisis to the multi-agent shared memory vault and Data Sovereignty Covenant.

### What is the Universal Multi-Toolchain Clean Engine (sila clean)?

Sila includes a built-in clean command that safely scans and reclaims gigabytes of disk bloat across 9 developer ecosystems: Go, Rust/Cargo, pnpm, aube, npm, uv/pip, bun, zig, and mise, featuring strict path traversal guards and MCP cache pruning.

### Where is my session data stored and does Sila phone home?

Sila is strictly local-first and zero-telemetry. Under the Digital Data Sovereignty Covenant, all session memory, architectural directives, and lessons are stored in an open relational pure-Go SQLite database directly on your machine.

### How does the Sila Go Plugins subsystem work?

Sila supports standalone Go plugins that compile against the Sila Plugin Standard Specification v1.0.0. Plugins can be initialized, installed, linked, and dynamically bridged into native MCP tools via `sila plugins` and `internal/mcp/plugins_provider.go`.

### How do I request early access or a pilot integration?

Reach out directly to Jad Madi (@jadmadi on X) or submit an inquiry via the contact form on jadmadi.net for integration reviews and enterprise pilots.

## Links & Resources

- Interactive Project Page: https://jadmadi.net/project/sila/
- Official Website: https://sila.jadmadi.net
- GitHub Repository: https://github.com/jadmadi/sila
- Documentation: https://github.com/jadmadi/sila/blob/main/README.md
- Standalone Binaries: https://sila.jadmadi.net/sila/
- Author: [@JadMadi](https://x.com/jadmadi)
