CodeStory builds a local code map for coding agents
CodeStory is a Rust for reducing repeated setup work in coding-agent sessions. It builds a read-only local graph of a repository, including files, symbols, references, links between code elements, and snapshots. Agents can use that local index to move around the codebase, ground answers in the right files, plan reviews, and build smaller useful context.
It uses tree-sitter to extract structure from Rust, Python, JavaScript/TypeScript, Java, Go, C/C++, C#, Kotlin, Swift, Dart, Ruby, PHP, Bash, and some structural formats. The index is stored in SQLite and includes files, symbols, edges, occurrences, and snapshots. When possible, it plans incremental refreshes instead of rebuilding the whole index.
It also supports text search over source code and generated symbol notes, plus hints about which files may be affected for review or test planning. The index can be reused across parallel , and the project is available under the .
Key points
- CodeStory creates a reusable local graph of a for .
- It stores files, symbols, references, edges, occurrences, and snapshots in SQLite.
- It supports many common languages, including Rust, Python, JavaScript/TypeScript, Go, Java, and C/C++.
- It can refresh changed parts when possible instead of rebuilding everything.
- It can help with code navigation, review planning, test planning, and compact context building.