codivew
v0.4.0
Published
Codivew CLI for AI code reviews through OpenAI-compatible APIs
Downloads
2,521
Maintainers
Readme
Codivew
English | 한국어
Codivew reviews Git changes through an OpenAI-compatible API and generates standalone HTML or machine-readable JSON reports. It runs without a separate Codivew server or database.
Features
- Review working tree, staged, or branch changes
- Get a summary and feedback by file and changed line
- Browse diffs in a collapsible, standalone HTML report
- Export structured review results as JSON
- Automatically exclude sensitive and generated files
Requirements
- Node.js 18 or later
- Git
- An OpenAI-compatible API with model listing and chat completion endpoints
Local Ollama works through its OpenAI-compatible endpoint. Pull a model before using it:
ollama pull qwen3.6:35b-a3b-coding-mxfp8Installation
npm install -g codivew
codivew setupsetup lets you choose ko-KR or en, an authentication method (None, API Key/Bearer, or Basic Authentication), the API URL, and a model returned by GET /v1/models. Reviews use POST /v1/chat/completions. The local Ollama default is http://localhost:11434/v1 with no authentication.
Run codivew setup again at any time to change the endpoint or authentication. Credentials are entered without terminal echo, stored only in the user configuration file with owner-only permissions, and never displayed by config show.
Change the saved language without running setup again:
codivew config set language en
codivew config set language ko-KRTo update Codivew:
npm install -g codivew@latestUsage
Run Codivew anywhere inside a Git repository.
# Review unstaged changes and untracked files
codivew
codivew working
# Review staged changes
codivew staged
# Review changes between main and HEAD
codivew branch
# Use a different base branch
codivew branch --base developAdd project context with repeatable --context options:
codivew staged \
--context "Node.js CLI project" \
--context "Must support Node.js 18 or later"Use a different OpenAI-compatible endpoint or model for one review. Saved authentication is still used:
codivew staged \
--api-url https://api.example.com/v1 \
--model qwen3.6:35b-a3b-coding-mxfp8View all commands and options with:
codivew --helpOutput
Reports are saved under .codivew/ in the directory where the command was run. HTML reports open automatically in your browser.
.codivew/Use --no-open to prevent the browser from opening, or --output to choose the report path:
codivew staged --no-open
codivew staged --output ./reports/review.html
codivew staged --format json
codivew staged --format both --output ./reports/review--format accepts html (default), json, or both. JSON-only output never opens a browser. With both, Codivew writes .html and .json files using the same base name and opens only the HTML report.
Excluded Files
Codivew excludes lockfiles, build output, generated files, environment files, private keys, certificates, minified JavaScript, and source maps. .env.example and .env.sample remain included.
