The Codestory CLI is a high level interface over git. Why? Git is a powerful tool. It is also an excellent tool for shooting yourself in the foot.
While Git provides the infrastructure for version control, you rarely need to be down in the pipes for daily work. Codestory lets you do 99% of regular tasks much more effectively. When you need Git, its always there for those more complex tasks. It does not replace Git; it allows you to use it effectively without the headache.
Codestory provides powerful commands to enhance your version control workflow: commit changes into small, logical commits with AI-generated messages; fix past commits by intelligently splitting them into more focused changes; clean entire repository histories to improve commit quality; and configure settings to tailor the tool to your needs.
Think of this as a natural transition to a higher-level version control, where you can worry less about housekeeping and focus on building.
For detailed instructions on how to install and use the Codestory CLI, visit our getting started page.
For comprehensive guides, configuration priority, and supported languages, visit our docs page.
The documentation site provides detailed information on:
- Usage Guides
- Configuration Scopes (Global vs. Local vs. Env)
- Supported Model Providers and Languages
- Core Design and Architecture
For a real example of what codestory can do, checkout the main-cleaned branch of this repository. It is a cleaned up version of the main branch of this repository, created using the cst clean command.
If you find a bug, feel free to create a pull request.
The code is licensed under GPLv2, just like Git.