Korekt CLI

AI-powered code review CLI - Keep your kode korekt

kk integrates seamlessly with your local Git workflow to provide intelligent code reviews powered by AI.

Features

• AI-Powered Analysis: Get instant, intelligent code reviews with severity levels, categories, and actionable suggestions
• Local Git Integration: Works with committed changes, staged changes, and unstaged modifications
• Ticket Context Enrichment: Server-side ticket extraction from branch names and commit messages (Jira & Azure DevOps)
• Beautiful Output: Color-coded issues with severity indicators, file locations, and suggested fixes
• Ultra-Fast: Short command syntax (kk) for maximum developer efficiency

Installation

npm install -g korekt-cli

Quick Start

Configure the CLI with your API credentials:

kk config --key YOUR_API_KEY
kk config --endpoint https://api.korekt.ai/api/review

Run your first review:

# Review committed changes against a target branch
kk review main

# Review only staged changes
kk stg

# Review only unstaged changes
kk diff

Usage

Configuration

# Set API key
kk config --key YOUR_API_KEY

# Set API endpoint
kk config --endpoint https://api.korekt.ai/api/review

# Show current configuration
kk config --show

Review Commands

# Review committed changes (auto-detect base branch)
kk review

# Review against specific branch
kk review main

# Review with ignored files
kk review main --ignore "*.lock" "dist/*"

# Dry run (preview payload without sending)
kk review main --dry-run

# Output JSON for CI/CD integration
kk review main --json

# Review staged changes only
kk stg
# Aliases: kk staged, kk cached

# Review unstaged changes only
kk diff

# JSON output works with all review commands
kk stg --json
kk diff --json

Alternative Command

Both kk and korekt commands are available:

korekt review main  # Same as: kk review main

Environment Variables

You can also configure using environment variables:

export KOREKT_API_KEY="your-api-key"
export KOREKT_API_ENDPOINT="https://api.korekt.ai/api/review"

Note: Config file takes precedence over environment variables.

Help

For more options and detailed help:

kk --help
kk review --help

Development

To run tests:

npm test

License

MIT © Vladan Djokic

See LICENSE for details.