Softwarev0.15 releasedJun 18, 2026

CodeStory

A local code map that gives coding agents cited repository context before they plan, edit, or review a change.

Install for Codex Source code Download v0.15

Status: v0.15 released; v0.16 in development
Works with: Codex, Cursor, Claude Code, and Copilot
Built with: Rust, MCP, SCIP, and CodeRankEmbed
License: Apache 2.0

A real CodeStory trail through ResolutionPass: 19 symbols and 32 member and call relationships.

Overview

What it is

CodeStory is a local code map for coding agents. It gives an agent durable, cited context about files, symbols, routes, call paths, snippets, search evidence, and likely change impact before the agent starts changing things.

The map and queries stay on the machine by default. Public v0.15 packages are available for macOS, Windows, and Linux; the local v0.16 source line is still unreleased and continues to simplify the embedded retrieval runtime.

On an 18-task public-repository holdout, the current recorded suite used 43% fewer context tokens, 45% less repeat-task wall time, and 87% fewer tool calls with CodeStory than without it. Those numbers describe the pinned evaluation—not every language or private repository.

Capabilities

What it does

01
Grounds the repository
Builds a compact repository map before an agent begins editing, including languages, components, routes, and important paths.
02
Navigates symbols and impact
Finds definitions, callers, references, trails, likely tests, and change impact without repeatedly rereading the whole tree.
03
Broadens retrieval
Combines lexical, semantic, graph, and SCIP evidence into source-cited search results and answer packets.
04
Fails closed
Reports stale, partial, or incoherent coverage as a gap instead of silently presenting an incomplete map as truth.
05
Handles several repositories
Keeps repository indexes isolated while sharing one warm embedded retrieval engine across several checkouts.
06
Keeps the work local
Keeps repository maps and queries on the machine. The unreleased v0.16 source line also moves the model and accelerator engine into the CLI itself.

Why I built it

Coding agents spend a surprising amount of time rediscovering the same repository. Broad scans burn context, and partial maps can be worse than no map when they look complete.

CodeStory gives the agent a local, source-cited map and makes coverage gaps visible. The goal is not more context. It is the smallest trustworthy context for the change in front of you.

Where it stands

The public v0.15 release ships packages for macOS, Windows, and Linux and supports Codex, Cursor, Claude Code, and Copilot adapters. The v0.16 source line is still unreleased.

Current evaluation evidence shows large reductions in repeated source reads, tool calls, context tokens, and repeat-task time on a pinned 18-task holdout. The project states the limits of that evidence alongside the numbers.

Project links

Grounds the repository

Navigates symbols and impact

Broadens retrieval

Fails closed

Handles several repositories

Keeps the work local

Why I built it

Where it stands