Give your project a good story.
Stop committing "blobs" of changes. CodeStory analyzes your work and programmatically constructs a linearized sequence of atomic, logically grouped commits.
Logical Grouping
Reads your working changes and constructs a linearized sequence of atomic commits. No more opaque "WIP" commits.
Safe by Design
Read-only with respect to your source files. We manipulate Git index objects to build history, leaving your working tree untouched.
Language Aware
Uses Tree-sitter to respect language syntax and scope, ensuring semantically coupled edits stay together.
How it works
A multi-stage pipeline for programmatically constructing Git history.
Mechanical Chunking
The engine decomposes your working tree diff into the smallest possible atomic hunks. By validating each hunk against the Git index, we ensure that any subset of these chunks can be staged independently without causing merge conflicts or corrupted state.
Semantic Analysis
Using Tree-sitter, we perform AST-level analysis on modified files. We track symbol definitions, references, and scope boundaries to ensure that semantically coupled changes—such as a function signature update and its internal call sites—are never separated into different commits.
Logical Grouping
For high-level relationships that static analysis cannot resolve, we leverage LLMs to analyze the intent behind the changes. This stage groups logically related edits across disparate files—like a backend API change and its corresponding frontend consumer—into a single, coherent commit.
Ready to give your project a good story?
Join developers who care about clean history. Install CodeStory today and start committing with intent.
Get Started Now