KodrDriv is an AI-powered Git workflow automation tool that generates intelligent commit messages and release notes from your code changes. It analyzes your repository to create meaningful documentation while automating the entire release process.
Writing good commit messages and release notes is time-consuming and often done when you're least in the mood for reflection. KodrDriv was created specifically to solve the "context switch" problem that happens when you've been deep in code and Git asks you to summarize what you've done.
KodrDriv reads your code changes and Git history to automatically generate contextual, meaningful documentation that reflects your actual work.
npm install -g @eldrforge/kodrdrivgit add .
kodrdriv commitkodrdriv releasekodrdriv publishkodrdriv select-audio # Configure microphone (one-time setup)
kodrdriv audio-commit # Record audio to generate commit messages- AI-Powered Analysis - Uses OpenAI models to understand your code changes
- GitHub Issues Integration - Automatically analyzes recently closed issues to provide context for commit messages, prioritizing milestone-relevant issues
- Adaptive Diff Management - Automatically handles large diffs with intelligent truncation and retry logic to ensure reliable LLM processing
- Comprehensive Release Automation - Handles dependency updates, version bumping, PR creation, and GitHub releases
- Audio-Driven Workflows - Record audio to provide context for commits and reviews
- Intelligent Workspace Management - Provides tools for linking and managing related packages in monorepos
- Flexible Configuration - Hierarchical configuration with command-line overrides
Set up your environment variables:
export OPENAI_API_KEY="your-openai-api-key"
export GITHUB_TOKEN="your-github-token" # Required for publish commandInitialize configuration files:
kodrdriv --init-config
kodrdriv --check-config📚 Comprehensive Documentation
- All Commands Overview - Complete command reference with examples
- commit - Generate intelligent commit messages
- audio-commit - Record audio for commit context
- review - Analyze review notes and create GitHub issues
- audio-review - Record audio for review analysis
- release - Generate comprehensive release notes
- publish - Automate the entire release process
- link - Link local packages for development
- unlink - Remove workspace links
- clean - Clean generated files
- select-audio - Configure audio device
- Configuration - All configuration options and environment variables
- Customization - Custom instructions, personas, and override structures
- Examples - Practical usage examples and common workflows
- Architecture - Technical architecture and design
- Assumptions - Development assumptions and conventions
We welcome contributions! Please see our Contributing Guide for details.
Apache-2.0 - see LICENSE file for details.
Like Thor's hammer, this tool smashes through your repetitive coding tasks. But unlike Mjölnir, it won't make you worthy — it'll just make you faster. Strike through commits, forge releases, and channel the lightning of AI to automate your workflow. Because sometimes you need a hammer, and sometimes you need a tool that actually works. Pirate. TEST