sage

AI-powered Git assistant — commit messages, PR summaries, code reviews & risk reports from your terminal.

Supports Claude, OpenAI, and Ollama. Your API key stays on your machine.

Install

pnpm add -g @drixev/sage
# or
npm install -g @drixev/sage

Quick start (60 seconds)

1. Configure your AI provider

# Claude (recommended)
sage auth -a claude -k sk-ant-xxxxxxxxxx -m claude-haiku-4-5-20251001

# OpenAI
sage auth -a openai -k sk-xxxxxxxxxx -m gpt-4o-mini

# Ollama (fully local, no API key needed)
sage auth -a ollama -m llama3.2 -u http://localhost:11434

2. Stage your changes and run

git add .
sage commit

✔ Commit message ready!

  Suggested commit:

    feat(auth): add JWT refresh token rotation on expiry

Commands

sage commit — generate a commit message

git add .
sage commit          # shows suggestion, you decide
sage commit --yes    # commits immediately

sage review — code quality review

sage review                      # staged changes
sage review --file src/auth.ts   # specific file
sage review --changes            # staged + unstaged
sage review --generate           # save to markdown

sage risk — security & risk analysis

sage risk                # whole codebase
sage risk --staged       # staged changes only
sage risk --changes      # staged + unstaged changes
sage risk --ignoreTest   # skip test files from analysis
sage risk --generate     # save report to markdown

  File              Severity   Risks
  ─────────────────────────────────────────────────
  src/auth.ts       HIGH       JWT secret from env without validation
  src/db.ts         MEDIUM     Raw SQL interpolation on line 42

sage summary — PR description from your commits

sage summary           # last 10 commits
sage summary -c 20     # last 20 commits
sage summary --generate

sage daily — Daily scrum speech from your commits

sage daily           # last 5 commits
sage daily -c 20     # last 20 commits

sage config — view current settings

sage config
sage config --model
sage config --apikey

sage rules — view and generate current rules

sage rules
sage rules --generate
sage rules --reset

sage stats — shows your local commit history

sage stats

Privacy

• API keys stored in ~/.config/sage/config.json with 0o600 permissions
• Nothing is sent to any server other than your chosen AI provider
• No telemetry, no tracking

License

MIT © drixev