carbon-review

Usage

Quick Start

GROQ_API_KEY=gsk_... carbon ./src

Points Carbon at a directory and launches the TUI. Use arrow keys to browse files, press Enter to review, and read the AI feedback.

CLI Options

carbon [OPTIONS] [DIR]
----providerAI provider (groq, ollama, openai)
----modelAI model (overrides env, empty = use default)
----summaryBatch mode -- generate a report file
----formatOutput format: html, md, txt (default: html)
----outputOutput file path (default: summary.<format>)
----delaySeconds between API calls (default: 2)

Providers

GroqGROQ_API_KEY

Free tier available. Recommended for quick starts. Lists all available models in the TUI settings.

OpenAIOPENAI_API_KEY

Paid API. Lists all available models in the TUI settings (default: gpt-4o-mini).

OllamaOLLAMA_URL (optional)

Local. Defaults to http://localhost:11434. Scans pulled models via /api/tags (default: llama3.2).

TUI Keybindings

j / k or arrowsNavigate file tree
Enter / RightOpen directory or review file
LeftCollapse directory
sOpen settings (provider, model)
rRescan directory
j / k (review)Scroll review panel
Ctrl+j / Ctrl+kScroll code panel
q / EscQuit