Skip to content

Architecture & Design

Explore the internal mechanics of Codestory CLI. Our architecture is designed to transform complex code changes into a clean, atomic history while maintaining safety and technical integrity at every step.

Core Pipeline

  • The Core Logic: A high-level overview of how changes flow through our analysis engine.

  • Mechanical Chunking: How we break down raw diffs into independent, atomic units.

  • Semantic Grouping: Using tree-sitter to understand the structural context of your code.

  • Logical Grouping: The AI layer that identifies human intent and organizes changes into logical commits.

  • Commit Strategy: How we safely reconstruct a new Git history from analyzed groups.