Skip to content

Latest commit

 

History

23 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LEIO Code icon

LEIO Code — Give your coding agent a map.

Find the right files. Follow the calls. Pick up where you left off.

See LEIO in action · Install with one prompt · Read the benchmarks

LEIO Code: a request becomes bounded context, a code graph, and a persistent navigation session

LEIO Code gives your local coding agent repository context it can act on. A Rust CLI and 18-tool stdio MCP turn a task into a ranked working set, expose indexed callers and imports, and keep a session cursor as the agent explores. Each repository keeps its own index and JSON-LD evidence trail.

Local stdio · Stateful navigation · Open source: MIT OR Apache-2.0

Less searching. More understanding.

When your agent needs to… LEIO gives it…
Get oriented in an unfamiliar repository A bounded context bundle with ranked files and follow-up calls
Check what a change might affect Indexed callers, callees, imports and concrete callsites
Explore without losing its place Named sessions, a cursor, selection, back and forward
Leave inspectable evidence Repository-local artifacts and JSON-LD provenance events

Code indexing and navigation run locally. Optional configured services have their own network behavior. Retrieval is a starting point for inspection; indexed relationships do not prove runtime behavior or complete call coverage.

Watch the workflow

Illustrative LEIO navigation sequence: context, symbol selection, callees, and back

Illustrative walkthrough, not a recorded terminal or a timing measurement. Static, motion-free walkthrough · Interactive site

Built for the investigation—not just the lookup.

Three guided investigations complete in median 1.42 to 1.49 seconds through 11 MCP tool calls and a provider reconnect

Three real code paths. 11 MCP tool calls per run. Find context, inventory symbols, follow a callee, return to the starting symbol, restart the provider, and confirm the session cursor is still there.

Guided investigation Median full sequence
Trace context ranking 1.49 s
Follow workflow policy dispatch 1.46 s
Investigate MCP binary selection 1.42 s

15 of 15 scripted runs passed, including cursor restoration after provider restart. Measured on this repository's 420 indexed files, Apple M1, release 2.6.2. Five runs per scenario; warm index/graph. Timings include the 11 calls, checks and reconnect; setup is excluded.

These are guided navigation benchmarks with labeled targets, not autonomous bug fixes or an agent productivity comparison. Every sample, including the slowest 1.71 s run, is published with the methodology.

See the complete benchmark and reproduce it →

Install with one prompt

Paste this into a local coding agent with terminal access:

Install the official LEIO Code local stdio MCP from https://github.com/josaum/leio-code by following docs/install-stdio.md. Inspect the installation script, check prerequisites, build the locked source, and verify the actual MCP handshake, 18 tools, context and session navigation. Register only the leio-code stdio server in this host, preserving other MCP entries. Use absolute paths and the installer output. Do not enable the HTTP integration. Tell me whether a host reconnect is required and report the installed revision and verification results.

Or install from source yourself:

git clone https://github.com/josaum/leio-code.git ~/.local/share/leio-code/source
cd ~/.local/share/leio-code/source
bash scripts/install-stdio.sh

Requires Git, a C/C++ toolchain, stable Rust, Node.js 22+ and npm. Compilation can take several minutes. The installer verifies the real stdio connection and prints MCP configuration. Register it in your host and reconnect; keep the checkout. No hosted HTTP service or SSH key is required. This is a source installation; prebuilt binaries and npm publication are not claimed.

Complete setup and updates · Source release

Your first useful query

leio-code --repo /absolute/path/to/repo init
leio-code --repo /absolute/path/to/repo context "fix the payment validation flow"

Read the returned files, inspect exact symbols with graph symbols-in, then use the returned symbol identity to navigate. Pin the repository and an explicit session when multiple agents work in the same tree.

Go deeper

Guide Start here for…
Product tour Context → graph → navigation, step by step
Technical guide CLI commands, storage, knowledge, profiles and development
Agent skill The canonical tool-routing contract
Context bundles Ranking and retrieval limits
Benchmarks Public measurements and reproducibility
Conversation evidence Working with explicitly selected conversation files
Optional HTTP integration Hosted adapter setup and its separate capabilities
Contributing A focused change, a clear check, and a reviewable PR

Built to inspect

First-party source is licensed under MIT OR Apache-2.0, at your option. Dependencies retain their own licenses; see third-party notices. The public source policy describes the distribution.

About

Give your coding agent a map: local repository context, code graphs, stateful navigation and JSON-LD evidence through 18 stdio MCP tools.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages