KodrDriv - AI-Powered Git Workflow Automation

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.

🤖 For AI Assistants

Complete AI Guide: AI-GUIDE.md - Comprehensive documentation for AI assistants helping with kodrdriv

Quick Start: guide/index.md - Navigation hub for all guides

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.

Requirements

• Node.js 24.0.0 or higher - KodrDriv uses Vite 7+ which requires Node.js 24+
• Git installed and configured
• OpenAI API key (for AI-powered content generation)

To check your Node.js version:

node --version

If you need to upgrade Node.js, visit nodejs.org or use a version manager like nvm.

Installation

npm install -g @grunnverk/kodrdriv

🤖 MCP Integration

KodrDriv supports the Model Context Protocol (MCP), enabling AI assistants like Cursor to directly invoke kodrdriv commands.

Features

• 14 Fully Implemented Tools: All kodrdriv commands including automated publish→development workflow
• 8 Resources: Access configs, status, workspace data via kodrdriv:// URIs
• 6 Workflow Prompts: Guided multi-step operations

Quick Setup for Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "kodrdriv": {
      "command": "kodrdriv-mcp"
    }
  }
}

Then simply ask: "Use kodrdriv to commit my changes"

Documentation

• Integration Guide - Complete MCP documentation
• MCP Configuration Guide - Configure Kodrdriv via MCP
• Tools Reference - All 14 tools
• Resources Reference - All 8 resources
• Prompts Reference - All 6 workflows

Quick Start

Generate a Commit Message

git add .
kodrdriv commit

# With detailed analysis report
kodrdriv commit --self-reflection

# With context files
kodrdriv commit --context-files IMPLEMENTATION.md --sendit

Generate Release Notes

kodrdriv release

# With context and analysis
kodrdriv release --context-files CHANGELOG.md --self-reflection

Automate Your Release Process

kodrdriv publish

Smart Git Operations

# Smart pull with auto-conflict resolution
kodrdriv pull
kodrdriv tree pull  # Pull all packages in monorepo

# Update dependencies with AI analysis
kodrdriv tree updates --report   # See dependency conflicts
kodrdriv updates --analyze       # Get AI upgrade recommendations

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 with tool-calling for deep investigation
  • Always-on agentic mode for intelligent 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
• Smart Git Operations - Intelligent handling of common git pain points
  • Smart Pull - Auto-resolves package-lock.json, version bumps, and build artifacts
  • Dependency Analysis - AI-powered upgrade recommendations with version conflict detection
• Context Files - Pass documentation files as context for better AI understanding
• Human-Readable Output - Professional tone without AI slop, emojis, or marketing speak
• 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

# If using a project-scoped API key (starts with sk-proj-):
export OPENAI_PROJECT_ID="proj-your-project-id"

Note: If your OpenAI API key starts with sk-proj-, you must also set OPENAI_PROJECT_ID. You can find your project ID in the OpenAI dashboard. Alternatively, create a legacy API key (starts with just sk-) to avoid needing the project ID.

Initialize configuration files:

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

Documentation

📚 Comprehensive Documentation

🤖 AI-Friendly Guides

NEW: Complete guide system designed for AI assistants and developers:

• AI Guide (Master) - Complete reference for AI assistants
• Guide Directory - 13 focused guides covering everything
  • Quick Start - 5-minute setup
  • Integration - Add to your project
  • Usage - Common workflows
  • Commands - Quick reference
  • Configuration - All options
  • AI System - How AI works
  • Debugging - Troubleshooting
  • Architecture - System design
  • Development - Extend kodrdriv
  • Testing - Test suite
  • Tree Operations - Multi-package
  • Monorepo - Monorepo workflows

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
• pull - Smart pull with auto-conflict resolution
• updates - Dependency updates with AI analysis
• 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 TEST