clay-good/OpenLore

View on GitHub ↗

Deterministic, local-first memory and guardrails for AI coding agents with no LLM in the hot path.

284 ★35 forksTypeScriptUpdated 18d ago

What you need to know

OpenLore is a deterministic, local-first memory and guardrails system for AI coding agents (npm openlore, MIT, Node 22.13+) — static-analysis-driven with no LLM in the hot path: orient() tells an agent what a task touches, and governance tools certify changes (breaking-change verdicts, sensitive-boundary checks, claim verification, commit gates) across 18 languages + 12 IaC ecosystems.

Install

npm install -g openlore && openlore install   (auto-detects agent, wires orient(), registers MCP server, builds index)
No API key needed for analyze/drift/mcp/init and all governance tools

Usage

  • Ask your agent orient("add a payment method") to start already knowing the relevant functions, callers, specs, tests
  • Before commit: use blast_radius, certify_public_surface, change_impact_certificate, verify_claim, and openlore enforce --hook
  • openlore prove --estimate projects whether the tool pays for itself on your repo (no key)

Key features

  • One-time static analysis (tree-sitter) builds a live SQLite knowledge graph (call structure, types, tests, decisions, IaC) — app code, IaC, and decisions on one graph
  • 73 MCP tools: orient(), search_code, analyze_impact, trace_execution_path, select_tests, find_dead_code, blast_radius, change_impact_certificate, certify_public_surface, verify_claim, record_decision, and more
  • Governance guardrails: breaking/non-breaking verdicts with named consumers, differential sensitive-boundary checks, confirmed/refuted/unverifiable claim verification with citations, one commit gate (advisory by default)
  • Epistemic Lease tells the agent when context has gone stale; self-invalidating memory that survives renames; federation (cross-repo) and SCIP export
  • Measured: -26% round-trips on deep tasks in large repos; ~430µs p50 orient on a 15k-node graph; 5500+ tests; no telemetry

Best for

Large, unfamiliar, or polyglot codebases (code + IaC) where agents need deterministic structural context and pre-commit safety verdicts without any LLM in the retrieval path.

Caveats

  • Static-analysis only: reflective dispatch, computed eval/DI registries, and cross-language bridges may be silently absent from the graph
  • Best on deep/large-repo tasks; on small familiar repos it can add overhead (the README publishes the losses next to the wins)
  • API key only needed for optional spec generation (openlore generate); everything else works offline deterministically
Platforms: macOS · Linux · WindowsClients: Claude Code · Cursor · Cline · Continue · OpenCode · Codex · MCP clients
Documentation ↗

Reviewed 2026-08-11

Topics

adragentic-workflowsai-agentscall-graphcode-navigationcodebase-analysiscoding-agentsdead-code-detectiondeveloper-toolsinfrastructure-as-codeknowledge-graphliving-documentationllm-toolsmcp-servermodel-context-protocolscipsoftware-architecturestatic-analysistest-impact-analysistree-sitter
Stars
284★
Forks
35
Language
TypeScript
License
MIT
Created
2026-01-31
Last push
2026-08-17