LibreAI / Dev Tools / lean-ctx
// devtools · yvgude/lean-ctx

lean-ctx

LeanCTX — the Rust context gateway that controls what your AI coding tools can see.

★ 3.9k stars⑂ 351 forksApache-2.0updated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

lean-ctx is an open-source dev tools project by yvgude (yvgude/lean-ctx on GitHub). It has 3,870 GitHub stars and 351 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 8 October 2026.

Repository
yvgude/lean-ctx
GitHub stars
3,870
Forks
351
License
Apache-2.0
Last updated on GitHub
8 October 2026
Category
Dev Tools
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide the first concrete outcome you want from it, so you can pick the right example, template or mode instead of exploring everything at once.

  2. Get the project

    Clone the repository (or install the published package) and skim its README quick start for the requirements for your platform.

  3. Install and configure

    Run the documented install step and set any required configuration — such as provider keys, data sources or local services — before the first run.

  4. Run your first task

    Execute the smallest documented example end to end, confirm the output is what you expected, then adapt it to your real data or workflow.

// features

Why people love it

Context compression

16 read modes (full, map, signatures, diff, density and more), 85+ shell-output compression patterns and cached re-reads that return compact references.

Intelligent triage

An IntentEngine classifies query complexity and a ModePredictor learns the best read mode per file type, so simple lookups stay cheap.

Knowledge routing

Session memory, a temporal knowledge graph and a property graph of imports/calls/exports power impact analysis and search ranking.

Controls and governance

Configured path permissions, content filters and context budgets applied before delivery, with per-agent budgets and throttling profiles.

Cost intelligence

Local token/cost tracking, Shadow Mode savings estimates and CPAO (cost per accepted outcome) reporting via lean-ctx savings.

Inspectable proof

ctx_proof / ctx_verify export an audit trail of sources, policy decisions and pipeline provenance.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source so you can inspect, configure and run it locally.

    git clone https://github.com/yvgude/lean-ctx.git
    cd lean-ctx
  2. Set up your AI tool integration

    After installing LeanCTX (see the README install matrix for your platform), configure a supported integration.

    lean-ctx setup  # see README for the exact install command for your platform
  3. Track value

    Enable Shadow Mode, work normally, then check what LeanCTX saved.

    lean-ctx config set shadow.enabled true
    lean-ctx savings
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains lean-ctx?

It is maintained by yvgude on GitHub (yvgude/lean-ctx), where the source, issues and releases live.

Is it free to use?

Yes — it is free and open source under Apache-2.0, which permits use, modification and commercial redistribution, with licence/notice retention.

Does it need a paid API key?

No LLM API key of its own — LeanCTX prepares context locally; your existing AI tool keeps using its own model and key.

How does it compare to raw MCP filesystem servers or manual context stuffing?

Compared with raw MCP filesystem servers or manual context stuffing, lean-ctx's distinguishing focus is: leanCTX — the Rust context gateway that controls what your AI coding tools can see. Pick it when that focus matches your need; the alternative may suit you better if its broader or different scope is the priority.

How do I get started?

Clone https://github.com/yvgude/lean-ctx (or install its published package), follow the README quick start to install and configure it, then run the smallest documented example — the Run section on this page mirrors those steps.

// keep exploring

Similar tools

Dev Tools

ctx

Hunt down the lowest-cost AI coding setup your repo can rely on.

★ 588 starsMIT
View guide →
Dev Tools

agentacct

See what your coding agents did — and what each task cost in tokens.

★ 763 starsMIT
View guide →
Dev Tools

context-mode

Context optimization for coding agents: sandbox tool output, keep sessions lean, remember more

★ 25.7k starsElastic License 2.0
View guide →
Dev Tools

context-engineering-intro

Context engineering is the new vibe coding - it's the way to actually make AI coding assistants work. Claude Code is the best for this so that's what this re…

★ 13.9k starsMIT
View guide →
Dev Tools

InsForge

All-in-one open-source backend for agentic coding: database, auth, storage, hosting and AI gateway.

★ 13.1k starsApache-2.0
View guide →
Dev Tools

GrapeRoot

MCP graph engine that compounds context across AI coding assistants.

★ 1.0k starsApache-2.0
View guide →
// alternatives

Alternatives in Dev Tools

The most-starred other Dev Tools projects in the LibreAI catalogue — the realistic shortlist if lean-ctx is not the right fit.

Get lean-ctx

Free and open — grab the source, star the repo, and start creating.