Codestory CLI

Technical documentation for the Codestory CLI.

Codestory CLI is a tool for developers who value a clean, searchable, and reviewable Git history. It automates the creation of atomic commits from messy workflows

Technical Pillars

• Index-Only: Operates on state snapshots; never disrupts your working directory.

• Fully Sandboxed: Analysis happens in isolated temporary storage to keep your .git folder clean.

• Fully Atomic: Your branch history is only updated if the entire pipeline succeeds.

• Deterministic Semantic Analysis: Before involving any AI, we use tree-sitter to understand the semantic structure of your code.

• AI-Driven Semantic Clustering: We use AI to cluster your changes based on higher level relationships that cannot be captured by syntax.

---

Getting Started

• Installation Guide - Get up and running in minutes.
• Philosophy - Why atomic commits and clean history matter.
• Usage Guide - Learn the commit, fix, and clean workflows.

Deep Dives

• Architecture Overview - How the pipeline coordinates analysis.
• Mechanical Chunking - Deterministic decomposition of diffs.
• Semantic Grouping - Respecting code syntax with tree-sitter.
• Logical Grouping - Intent discovery and message generation.

Reference

• Command Reference - CLI flags and detailed command usage.
• Configuration - Settings and environment variables.
• Extensibility - Adding language support.