mcpField
K
kodevu

kodevu

github.com/gytengTesting & quality0687 installsUpdated 30w ago
Repository

About kodevu

kodevu is a Node.js command-line tool for reviewing Git commits or SVN revisions with supported AI reviewer CLIs. It saves Markdown or JSON reports and supports configurable reviewers, prompts, and persistent settings.

Key features

  1. 01Review Git commits and SVN revisions
  2. 02Review uncommitted changes
  3. 03Select supported reviewer backends
  4. 04Generate Markdown or JSON reports
  5. 05Configure prompts and persistent settings

Use cases

  1. 01Review the latest or selected commits
  2. 02Inspect uncommitted changes before committing
  3. 03Save reviews as JSON in a chosen directory
  4. 04Apply custom review instructions

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/gyteng/kodevu --skill kodevu

After installing, type/kodevuin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

package.json
.eslintrc.json
eslint.config.js
LICENSE
README.md
.gitignore
package-lock.json
.github/workflows/
publish-npm.yml
src/
diff-processor.js
config.js
logger.js
index.js
report-generator.js
shell.js
review-runner.js
progress-ui.js
git-client.js
svn-client.js
reviewers.js
prompts.js
token-usage.js
vcs-client.js
utils.js

Details

From the project README

Kodevu Skill

Kodevu is a Node.js tool that fetches Git commits or SVN revisions, sends the diff to a supported AI reviewer CLI, and writes review results to report files. It supports an optional persistent config file at ~/.kodevu/config.json for settings that should survive across sessions.

Usage

Use npx kodevu to review a codebase.

Reviewing the latest commit
npx kodevu .
Reviewing a specific commit
npx kodevu . --rev <commit-hash>
Reviewing the last N commits
npx kodevu . --last 3
Reviewing uncommitted changes
npx kodevu . --uncommitted
Supported Reviewers

kodevu supports several AI reviewer backends: auto, openai, gemini, codex, copilot. The default is auto, which probes available CLI tools in your PATH.

Example using OpenAI:

npx kodevu . --reviewer openai --openai-api-key <YOUR_API_KEY> --openai-model gpt-5-mini
Generating JSON Reports

By default, review reports are generated as Markdown files in ~/.kodevu/. You can specify --format json or change the output directory using --output <dir>.

npx kodevu . --format json --output ./reports
Custom Prompts

You can provide additional instructions to the reviewer using --prompt:

npx kodevu . --prompt "Focus on security issues and suggest optimizations."

Or from a file: --prompt @my-rules.txt

Environment Variables

All options can also be set via environment variables to avoid repetitive flags:

  • KODEVU_REVIEWER – Default reviewer.
  • KODEVU_LANG – Default output language.
  • KODEVU_OUTPUT_DIR – Default output directory.
  • KODEVU_PROMPT – Default prompt instructions.
  • KODEVU_OPENAI_API_KEY – API key for openai.
  • KODEVU_OPENAI_BASE_URL – Base URL for openai.
  • KODEVU_OPENAI_MODEL – Model for openai.
Configuration File

For persistent settings that survive across shells and AI tool invocations, create ~/.kodevu/config.json:

{
  "reviewer": "openai",
  "openaiApiKey": "sk-...",
  "openaiBaseUrl": "https://your-gateway.example.com/v1",
  "openaiModel": "gpt-4o",
  "lang": "zh"
}

The file is optional and silently ignored if absent. Priority: CLI flags > ENV vars > config file > defaults.

Working with Target Repositories

  • Git: target must be a local repository or subdirectory.
  • SVN: target can be a working copy path or repository URL.
npx kodevu /path/to/project --last 1

Comments

Markdown supported