{"id":36796379,"url":"https://github.com/grunnverk/kodrdriv","last_synced_at":"2026-03-15T20:14:54.491Z","repository":{"id":295183038,"uuid":"989420294","full_name":"grunnverk/kodrdriv","owner":"grunnverk","description":"Your Code Deserves Better","archived":false,"fork":false,"pushed_at":"2026-01-11T00:16:53.000Z","size":4930,"stargazers_count":0,"open_issues_count":116,"forks_count":0,"subscribers_count":0,"default_branch":"working","last_synced_at":"2026-01-11T01:35:11.234Z","etag":null,"topics":["code","code-automation","commit-message"],"latest_commit_sha":null,"homepage":"https://grunnverk.github.io/kodrdriv/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/grunnverk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-24T04:13:02.000Z","updated_at":"2026-01-11T00:15:40.000Z","dependencies_parsed_at":"2025-07-25T09:08:46.953Z","dependency_job_id":"3dd9a304-ce75-48c4-be12-3e346822ec78","html_url":"https://github.com/grunnverk/kodrdriv","commit_stats":null,"previous_names":["calenvarek/kodrdriv","grunnverk/kodrdriv"],"tags_count":113,"template":false,"template_full_name":null,"purl":"pkg:github/grunnverk/kodrdriv","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grunnverk%2Fkodrdriv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grunnverk%2Fkodrdriv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grunnverk%2Fkodrdriv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grunnverk%2Fkodrdriv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/grunnverk","download_url":"https://codeload.github.com/grunnverk/kodrdriv/tar.gz/refs/heads/working","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grunnverk%2Fkodrdriv/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28339123,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T12:22:26.515Z","status":"ssl_error","status_checked_at":"2026-01-12T12:22:10.856Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["code","code-automation","commit-message"],"created_at":"2026-01-12T13:30:18.501Z","updated_at":"2026-01-31T09:07:08.197Z","avatar_url":"https://github.com/grunnverk.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# KodrDriv - AI-Powered Git Workflow Automation\n\n\u003c!-- Build trigger: 2026-01-21 --\u003e\n\n[![MCP Integration](https://img.shields.io/badge/MCP-Enabled-blue)](https://modelcontextprotocol.io)\n[![14 MCP Tools](https://img.shields.io/badge/MCP_Tools-14-brightgreen)]()\n[![8 Resources](https://img.shields.io/badge/MCP_Resources-8-brightgreen)]()\n[![6 Prompts](https://img.shields.io/badge/MCP_Prompts-6-brightgreen)]()\n\n# KodrDriv\n\nKodrDriv 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.\n\n## 🤖 For AI Assistants\n\n**Complete AI Guide**: [`AI-GUIDE.md`](AI-GUIDE.md) - Comprehensive documentation for AI assistants helping with kodrdriv\n\n**Quick Start**: [`guide/index.md`](guide/index.md) - Navigation hub for all guides\n\n## Why KodrDriv?\n\nWriting 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.\n\nKodrDriv reads your code changes and Git history to automatically generate contextual, meaningful documentation that reflects your actual work.\n\n## Requirements\n\n- **Node.js 24.0.0 or higher** - KodrDriv uses Vite 7+ which requires Node.js 24+\n- Git installed and configured\n- OpenAI API key (for AI-powered content generation)\n\nTo check your Node.js version:\n```bash\nnode --version\n```\n\nIf you need to upgrade Node.js, visit [nodejs.org](https://nodejs.org/) or use a version manager like [nvm](https://github.com/nvm-sh/nvm).\n\n## Installation\n\n```bash\nnpm install -g @grunnverk/kodrdriv\n```\n\n## 🤖 MCP Integration\n\nKodrDriv supports the **Model Context Protocol (MCP)**, enabling AI assistants like Cursor to directly invoke kodrdriv commands.\n\n### Features\n- **14 Fully Implemented Tools**: All kodrdriv commands including automated publish→development workflow\n- **8 Resources**: Access configs, status, workspace data via `kodrdriv://` URIs\n- **6 Workflow Prompts**: Guided multi-step operations\n\n### Quick Setup for Cursor\n\nAdd to `.cursor/mcp.json`:\n```json\n{\n  \"mcpServers\": {\n    \"kodrdriv\": {\n      \"command\": \"kodrdriv-mcp\"\n    }\n  }\n}\n```\n\nThen simply ask: *\"Use kodrdriv to commit my changes\"*\n\n### Documentation\n- **[Integration Guide](MCP_INTEGRATION.md)** - Complete MCP documentation\n- **[MCP Configuration Guide](guide/mcp-configuration.md)** - Configure Kodrdriv via MCP\n- **[Tools Reference](docs/mcp-tools-reference.md)** - All 14 tools\n- **[Resources Reference](docs/mcp-resources-reference.md)** - All 8 resources\n- **[Prompts Reference](docs/mcp-prompts-reference.md)** - All 6 workflows\n\n\n## Quick Start\n\n### Generate a Commit Message\n```bash\ngit add .\nkodrdriv commit\n\n# With detailed analysis report\nkodrdriv commit --self-reflection\n\n# With context files\nkodrdriv commit --context-files IMPLEMENTATION.md --sendit\n```\n\n### Generate Release Notes\n```bash\nkodrdriv release\n\n# With context and analysis\nkodrdriv release --context-files CHANGELOG.md --self-reflection\n```\n\n### Automate Your Release Process\n```bash\nkodrdriv publish\n```\n\n### Smart Git Operations\n```bash\n# Smart pull with auto-conflict resolution\nkodrdriv pull\nkodrdriv tree pull  # Pull all packages in monorepo\n\n# Update dependencies with AI analysis\nkodrdriv tree updates --report   # See dependency conflicts\nkodrdriv updates --analyze       # Get AI upgrade recommendations\n```\n\n### Audio-Driven Development\n```bash\nkodrdriv select-audio  # Configure microphone (one-time setup)\nkodrdriv audio-commit  # Record audio to generate commit messages\n```\n\n## Key Features\n\n- **AI-Powered Analysis** - Uses OpenAI models with tool-calling for deep investigation\n  - Always-on agentic mode for intelligent analysis\n  - 13 specialized tools for release notes generation\n  - 8 tools for commit message generation\n  - Self-reflection reports with tool effectiveness metrics\n  - Configurable iteration limits for complex releases\n- **Smart Git Operations** - Intelligent handling of common git pain points\n  - **Smart Pull** - Auto-resolves `package-lock.json`, version bumps, and build artifacts\n  - **Dependency Analysis** - AI-powered upgrade recommendations with version conflict detection\n- **Context Files** - Pass documentation files as context for better AI understanding\n- **Human-Readable Output** - Professional tone without AI slop, emojis, or marketing speak\n- **GitHub Issues Integration** - Automatically analyzes recently closed issues to provide context for commit messages, prioritizing milestone-relevant issues\n- **Stop-Context Filtering** - Automatically filters sensitive information from AI-generated content to maintain privacy across projects\n- **Adaptive Diff Management** - Automatically handles large diffs with intelligent truncation and retry logic to ensure reliable LLM processing\n- **Comprehensive Release Automation** - Handles dependency updates, version bumping, PR creation, and GitHub releases\n- **Audio-Driven Workflows** - Record audio to provide context for commits and reviews\n- **Intelligent Workspace Management** - Provides tools for linking and managing related packages in monorepos\n- **Flexible Configuration** - Hierarchical configuration with command-line overrides\n\n## Configuration\n\nSet up your environment variables:\n```bash\nexport OPENAI_API_KEY=\"your-openai-api-key\"\nexport GITHUB_TOKEN=\"your-github-token\"  # Required for publish command\n\n# If using a project-scoped API key (starts with sk-proj-):\nexport OPENAI_PROJECT_ID=\"proj-your-project-id\"\n```\n\n**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](https://platform.openai.com/settings/organization/projects). Alternatively, create a legacy API key (starts with just `sk-`) to avoid needing the project ID.\n\nInitialize configuration files:\n```bash\nkodrdriv --init-config\nkodrdriv --check-config\n```\n\n## Documentation\n\n📚 **Comprehensive Documentation**\n\n### 🤖 AI-Friendly Guides\n\n**NEW**: Complete guide system designed for AI assistants and developers:\n- **[AI Guide (Master)](AI-GUIDE.md)** - Complete reference for AI assistants\n- **[Guide Directory](guide/)** - 13 focused guides covering everything\n  - [Quick Start](guide/quickstart.md) - 5-minute setup\n  - [Integration](guide/integration.md) - Add to your project\n  - [Usage](guide/usage.md) - Common workflows\n  - [Commands](guide/commands.md) - Quick reference\n  - [Configuration](guide/configuration.md) - All options\n  - [AI System](guide/ai-system.md) - How AI works\n  - [Debugging](guide/debugging.md) - Troubleshooting\n  - [Architecture](guide/architecture.md) - System design\n  - [Development](guide/development.md) - Extend kodrdriv\n  - [Testing](guide/testing.md) - Test suite\n  - [Tree Operations](guide/tree-operations.md) - Multi-package\n  - [Monorepo](guide/monorepo.md) - Monorepo workflows\n\n### Commands\n- **[All Commands Overview](docs/public/commands.md)** - Complete command reference with examples\n- **[commit](docs/public/commands/commit.md)** - Generate intelligent commit messages\n- **[audio-commit](docs/public/commands/audio-commit.md)** - Record audio for commit context\n- **[review](docs/public/commands/review.md)** - Analyze review notes and create GitHub issues\n- **[audio-review](docs/public/commands/audio-review.md)** - Record audio for review analysis\n- **[release](docs/public/commands/release.md)** - Generate comprehensive release notes\n- **[publish](docs/public/commands/publish.md)** - Automate the entire release process\n- **[pull](docs/public/commands/pull.md)** - Smart pull with auto-conflict resolution\n- **[updates](docs/public/commands/updates.md)** - Dependency updates with AI analysis\n- **[link](docs/public/commands/link.md)** - Link local packages for development\n- **[unlink](docs/public/commands/unlink.md)** - Remove workspace links\n- **[clean](docs/public/commands/clean.md)** - Clean generated files\n- **[select-audio](docs/public/commands/select-audio.md)** - Configure audio device\n\n### Configuration \u0026 Customization\n- **[Configuration](docs/public/configuration.md)** - All configuration options and environment variables\n- **[Customization](docs/public/customization.md)** - Custom instructions, personas, and override structures\n- **[Examples](docs/public/examples.md)** - Practical usage examples and common workflows\n\n### Technical Details\n- **[Architecture](docs/public/architecture.md)** - Technical architecture and design\n- **[Assumptions](docs/public/assumptions.md)** - Development assumptions and conventions\n\n## Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n## License\n\nApache-2.0 - see [LICENSE](LICENSE) file for details.\n\n## About the Name\n\nLike 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.\n\n\u003c!-- Build: 2026-01-15 15:59:12 UTC --\u003e\nTEST\nTEST\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrunnverk%2Fkodrdriv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgrunnverk%2Fkodrdriv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrunnverk%2Fkodrdriv/lists"}