crtea

crtea

An interactive terminal code review tool built with Bubble Tea.

This project is modeled after tuicr.

Features

• Commit picker — select working tree changes and/or individual commits to review
• Unified diff viewer — syntax-highlighted, scrollable diff with context expansion
• File tree — collapsible directory tree for navigating changed files
• Inline comments — add notes, todos, and issues anchored to specific lines or ranges
• Review sessions — persistent sessions that track reviewed files and comments
• Markdown export — export review notes to clipboard as Markdown
• Per-commit toggles — enable/disable individual commits to focus your review
• Review description — auto-generated squash-style summary from commit messages
• Themes — dark, light, glamour-dark, glamour-light, with auto-detection

Install

go install github.com/pgavlin/crtea@latest

Usage

crtea [options]

With no flags, crtea opens a commit picker where you can select which commits and/or working tree changes to review.

Options

Keybindings

Navigation

Review

Other

Embedding

The ui package exposes App as a reusable Bubble Tea component. Create one with ui.NewApp or ui.NewPickerApp and embed it in your own tea.Model:

import (
    "github.com/pgavlin/crtea/ui"
    "github.com/pgavlin/crtea/vcs"
    "github.com/pgavlin/crtea/theme"
)

// In your Update method, handle these messages from the component:
//   ui.DoneMsg     — user finished; Session field has the final review state
//   ui.ClipboardMsg — user wants to copy text to clipboard

app := ui.NewPickerApp(backend, theme.Dark(), highlighter, store)
app.SetSize(width, height)

License

See LICENSE for details.