KodrDriv

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.

Why KodrDriv?

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.

Installation

npm install -g @eldrforge/kodrdriv

Quick Start

Generate a Commit Message

git add .
kodrdriv commit

# Or use agentic mode for deep analysis
kodrdriv commit --agentic --self-reflection

Generate Release Notes

kodrdriv release

# Or use agentic mode for comprehensive analysis
kodrdriv release --agentic --self-reflection

Automate Your Release Process

kodrdriv publish

Audio-Driven Development

kodrdriv select-audio  # Configure microphone (one-time setup)
kodrdriv audio-commit  # Record audio to generate commit messages

Key Features

• AI-Powered Analysis - Uses OpenAI models to understand your code changes
• Agentic Mode (NEW) - AI-powered tool-calling for deep investigation and analysis
  • 13 specialized tools for release notes generation
  • 8 tools for commit message generation
  • Self-reflection reports with tool effectiveness metrics
  • Configurable iteration limits for complex releases
• GitHub Issues Integration - Automatically analyzes recently closed issues to provide context for commit messages, prioritizing milestone-relevant issues
• Stop-Context Filtering - Automatically filters sensitive information from AI-generated content to maintain privacy across projects
• 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

Configuration

Set up your environment variables:

export OPENAI_API_KEY="your-openai-api-key"
export GITHUB_TOKEN="your-github-token"  # Required for publish command

Initialize configuration files:

kodrdriv --init-config
kodrdriv --check-config

Documentation

📚 Comprehensive Documentation

Commands

• 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 & Customization

• Configuration - All configuration options and environment variables
• Customization - Custom instructions, personas, and override structures
• Examples - Practical usage examples and common workflows

Technical Details

• Architecture - Technical architecture and design
• Assumptions - Development assumptions and conventions

Contributing

We welcome contributions! Please see our Contributing Guide for details.

License

Apache-2.0 - see LICENSE file for details.

About the Name

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