Changelog.

What’s Changed

I’m very excited for this release! Several new features based on experience from dogfooding it for all my work as well as suggestions from our little community! Everyone who has reached out has been extremely thoughtful and kind. I truly appreciate all the feedback and comments, so please continue! ❤️

To upgrade:

brew update && brew upgrade crit

Config

Crit now reads a config file — ~/.crit.config.json globally, or .crit.config.json per-project. Project config takes precedence over global. Useful for setting ignore patterns, author name, and port.

{
  "port": 0,
  "no_open": false,
  "share_url": "https://crit.live",
  "quiet": false,
  "output": "",
  "author": "John",
  "ignore_patterns": [".crit.json"]
}

Scaffold a starter config with:

crit config --generate > ~/.crit.config.json

GitHub PR sync

This requires GitHub CLI to be installed.

Pull GitHub PR review comments down into your local .crit.json, review them in crit.

crit pull      # auto-detect PR from current branch
crit pull 123  # fetch PR #123 comments into .crit.json

Review a PR locally, add comments with crit and push them to the remote.

crit push             # post .crit.json comments to detected PR
crit push 123         # post to a specific PR
crit push --dry-run   # preview what would be posted

Programmatic comments

Your agents can leave comments directly into .crit.json without opening crit. Target a single line or a range:

crit comment main.go:42 "This will panic when input is nil"
crit comment auth.go:10-25 "Missing error handling for expired tokens" --author mybot

Comments written this way sync live to any running crit session via SSE.

You can find a new command, crit-comment to teach your agents how to do this in the integrations directory.

---

Release notes

Features

• feat: add persistent config files and ignore patterns by @tomasz-tomczyk in #43
• feat: comment template chips in comment form by @TickTockBent in #28
• feat: display review round badges on comments by @tomasz-tomczyk in #52 - thanks to Omer for the idea!
• feat: allow multiple comment forms open simultaneously by @tomasz-tomczyk in #55 - thanks to Omer and Jonny for the idea!
• feat: add comment count badge next to comment icon in header by @JonnyCBB in #34
• feat: preloaded .crit.json, GitHub PR sync, and crit comment CLI by @tomasz-tomczyk in #40
• Add author identity to config, comments, and share by @tomasz-tomczyk in #45

Fixes

• fix: syntax highlighting in comments + sidebar link styling by @tomasz-tomczyk in #42
• fix: keep existing comment ranges highlighted when starting a second comment by @tomasz-tomczyk in #57
• fix: handle blank context lines from diff.suppressBlankEmpty by @tomasz-tomczyk in #41
• fix: sync crit comment writes to running server via SSE by @tomasz-tomczyk in #50

Documentation

• Add OpenCode integration and Nix dev shell by @vereis in #38
• fix: make Nix flake runnable again by @vereis in #35
• docs: restructure README by @tomasz-tomczyk in #44
• fix: expose crit as a named package by @vereis in #37
• docs: prefer nix run in README by @vereis in #36

E2E Tests

• Fix intermittent E2E test failures by @tomasz-tomczyk in #51
• fix: improve scope-toggle E2E test reliability by @tomasz-tomczyk in #54
• fix: isolate E2E tests from user config by @tomasz-tomczyk in #56

What’s Changed

• Fix resolved comments not carrying forward across rounds — agents write resolution_lines as a string (e.g. "22-40") but crit expected []int, causing JSON parsing to fail silently and lose all comment state (8daf082)

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.4.8…v0.4.9

What’s Changed

• View all comments panel (#30)
• Fix scope switching hang when files not in session (b56baad)
• Fix unstaged scope showing full file instead of unstaged changes (#27)
• Persist viewed state across round transitions (85230bd)
• Render markdown in resolved comment bodies (6c36ddd)
• Use correct CSS variables in server-stopped modal (9e3dd42)
• Fix empty diffs when cwd is not repo root (#26)
• Only show TOC shortcut key when TOC is enabled (89af5cb)
• Gate release on unit and E2E tests passing (8f88e74)

Upgrade

# Homebrew
brew update
brew upgrade crit

# Nix flake
nix profile upgrade --inputs-from . crit

# Manual
# Download the binary for your platform from the assets below

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.4.7…v0.4.8

What’s Changed

• Make sharing opt-in by removing default crit.live URL — Share button now only appears when --share-url or CRIT_SHARE_URL is set (f3f570e)
• Hide prompt in waiting modal once agent starts editing (2a78ad3)
• Update the demo (6a0a5ea)

Upgrade

# Homebrew
brew update
brew upgrade crit

# Nix flake
nix profile upgrade --inputs-from . crit

# Manual
# Download the binary for your platform from the assets below

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.4.6…v0.4.7

What’s Changed

• Color-coded change highlights and n/N navigation in diff view (87993cc)
• Make n/N change navigation scroll-position-aware (be7550b)
• Add -o/--output flag to customize .crit.json location (cc8b866)
• Suppress tree observer during manual scroll to prevent active state race (6d8e8e2)

Upgrade

# Homebrew
brew update
brew upgrade crit

# Nix flake
nix profile upgrade --inputs-from . crit

# Manual
# Download the binary for your platform from the assets below

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.4.5…v0.4.6

What’s Changed

Features

• Add --quiet/-q flag to suppress status output (a8f99ac)
• Return all-resolved prompt when no unresolved comments remain (328352c)
• Add TOC scrollspy highlighting in file mode (92530d4)
• Highlight inter-round changes in file mode document view (1780090)
• Render code files in document view for file mode (30817d2)

Fixes

• Overlay document view comment button on line gutter (fe5a18b)
• Remove v keyboard shortcut for toggling viewed (8c6dd58)
• Scroll to file top when clicking tree item (1a24808)
• Hide change indicators and line numbers from git mode document view (5cc8b8f)
• Clear focused state after comment submit/cancel (79196c6)

Upgrade

# Homebrew
brew update
brew upgrade crit

# Nix flake
nix profile upgrade --inputs-from . crit

# Manual
# Download the binary for your platform from the assets below

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.4.4…v0.4.5

What’s Changed

• Restore rendered markdown diff view in file mode — “Toggle Diff” button shows rendered content with green/red highlighted blocks for additions/deletions, with split and unified layouts (#22)
• Fix TOC click navigation and state persistence (#21)
• Clean up file mode UI — hide status badges and show filename in header (1450849)

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.4.3…v0.4.4

What’s Changed

• Fix file mode rendering blank page when diff scope cookie is set from a previous git mode session (efce6c8)

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.4.2…v0.4.3

What’s Changed

• Add diff scope toggle — switch between all/branch/staged/unstaged changes (#20)
• Fix share button incorrectly showing in git mode (#19)

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.4.1…v0.4.2

What’s Changed

• Fix: carry forward comments for unedited files in file mode (#18)
• Fix: reduce left padding for comments in markdown view (e70bbfa)
• Docs: update README and integrations for unified plan + git review messaging (#17)
• Fix: terminal output counts carried-forward comments as new (#16)
• Fix: allow Playwright to reuse servers started by run.sh in CI (da9d00d)

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.4.0…v0.4.1

What’s Changed

• Multi-file review with git integration (#15)
• Add mise.toml for tool and dev task management (a940d57)

⚠️ Note: our file definition has changed. If you use skills or commands to instruct your agent, you probably want to update them - see https://github.com/tomasz-tomczyk/crit/tree/main/integrations

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.3.5…v0.4.0

What’s Changed

• Fix .comments.json loss on round-complete (#13)
• Add inline commenting to diff views and fix hover layout shift (#14)
• CLI polish and UI micro-delights (82d3b5f)
• README cleanup (74e233a)

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.3.4…v0.3.5

What’s Changed

• Fix finish keybind. Closes #12 (96588fa)
• Fix TOC highlighting always selecting last heading in diff view (e43ce17)
• Fix race conditions, improve security, and optimize performance (c7ddb5f)
• Add integrations documentation (54a470c)
• Documentation improvements (3cb3c1d)

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.3.3…v0.3.4

What’s Changed

• Replace in-flow notification banners with fixed toast notifications (#10)
• Carry forward unresolved comments to next review round (#9)
• Add polished CLI status output for review lifecycle (#8)

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.3.2…v0.3.3

What’s Changed

• Keyboard shortcuts for review navigation — j/k to move between comments, ? to toggle help (#6)
• Autosave comment drafts to localStorage so in-progress comments survive page reloads (#5)
• Hide keyboard shortcuts button on mobile to fix header layout (fc398e3)

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.3.1…v0.3.2

What’s Changed

• Design improvements: header, accessibility, dark theme contrast (#4)
• Add unified diff view (e283708)

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.3.0…v0.3.1

What’s Changed

• Multi-round review workflow & diff view by @tomasz-tomczyk in #3

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.2.1…v0.3.0

• Add update available notice in header https://github.com/tomasz-tomczyk/crit/commit/0df7705c3fa9255eb79b1b143d8a951fb2c02fbb
• Improve mobile header layout https://github.com/tomasz-tomczyk/crit/commit/ca15992c88669d582950532e304cf55329696f35

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.2.0…v0.2.1

What’s Changed

• Share feature by @tomasz-tomczyk in #2 - share your plan and source feedback from friends
• Don’t create comments JSON until there’s at least one comment
• Locally, body size limit increased to 10MB

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.1.2…v0.2.0

• Improved link styling in comments
• Add floating table of contents panel

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.1.1…v0.1.2

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.1.0…v0.1.1

Full Changelog: https://github.com/tomasz-tomczyk/crit/commits/v0.1.0