Skip to content

Playbooks for g

Story-style workflows—solo, team, and on-call. Jump into the full Use cases page anytime.

diff

Builtin diff engine — parsing, syntax highlighting, renderers, and review

auto-generated This page is built from //! comments in the Rust source. Edit the source and run npm run docs:extract to update it.

Builtin diff engine — parsing, syntax highlighting, renderers, and review comments.

In-process pipeline that produces a typed [parse::FileDiff] tree, highlights each line with [syntect], and renders it through one of three layouts inside the same ratatui TUI (stack / split / side-by-side) or as inline ANSI for non-interactive / non-TTY use. [reviews] provides the two-bucket review-comment coordination (public → GitHub, private → SQLite).

Folder layout

diff/
  mod.rs            ← this file: module root
  parse.rs          ← unified-diff parser (pure)
  highlight.rs      ← syntect engine + per-line span builder
  theme.rs          ← UI theme → syntect::Theme bridge
  render_inline.rs  ← ANSI renderer (non-TTY / --raw)
  render_tui.rs     ← ratatui app: layouts, sidebar, key loop
  reviews.rs        ← review-comment coordination (storage + GitHub)

Phase 1 scope: stack / split / side-by-side + inline fallback. Phase 2: review comments — public PR + private local notes.

Source: src/diff/mod.rs