Crit

Releases

Changelog.

What's new in Crit. Release notes pulled automatically from GitHub.

CLI

GitHub →
v0.5.2

What’s Changed

This release greatly improves some of our core commenting & diff functionality.

You can select any text to begin a comment. Those selected words will be recorded as a quote in the metadata for your comment in JSON, allowing more granularity for your feedback to your agent.

File mode diff view has been improved greatly - in the split view, we align horizontally the right sections together for easier comparison.

New: word-level diff highlighting, to make it easier to spot what’s actually changed.

General

Fixed

Internal refactors

Contributors

2x 2x dankilman dankilman ericsullivan ericsullivan omervk omervk
v0.5.1

What’s Changed

To upgrade:

brew update && brew upgrade crit

Workflow changes

You no longer have to manually copy/paste the prompt into the right terminal window!

I’ve added crit listen command which the agent should launch immediately after launching crit and each round. It blocks the agent and listens for you to hit Finish review in the UI.

I published crit as a plugin, which should make it easier to use and keep up to date with the commands and SKILL.md changes.

Claude Code:

/plugin marketplace add tomasz-tomczyk/crit
/plugin install crit

I’m trying to get published in the Claude Code and Cursor marketplaces - please ⭐ star the repo if you haven’t - it will help greatly - thank you!

  • refactor: restructure integrations as plugins with marketplace support by @tomasz-tomczyk in #62

Sharing

This release greatly improves the share capability. Please note, I added crit.live as the default share target but you can set SHARE_URL or share_url in config to a blank string to completely disable the sharing functionality.

I open sourced the web server package at crit-web! See full instructions for selfhosting there.

You can ask your agent to generate a share URL or QR code. Useful for planning on the go as our web view of the markdown files is mobile-friendly.

General

  • feat: Compact comment form button labels by @tomasz-tomczyk in #79
  • fix: disable hljs auto-detection for unlabelled code blocks by @tomasz-tomczyk in #66 (Thanks Omer for reporting!)
  • fix: restore review round from .crit.json on session restart by @tomasz-tomczyk in #81 (Thanks Omer for reporting!)
  • fix: flaky comment-count-badge E2E test race condition by @tomasz-tomczyk in #69
  • fix: update comment count badge on SSE comments-changed events by @tomasz-tomczyk in #68
  • fix: scope toggle ‘All’ re-queries git instead of using cached file list by @tomasz-tomczyk in #67
  • fix: add blue link styling to resolved comment bodies by @tomasz-tomczyk in #74

Docs

Full Changelog: https://github.com/tomasz-tomczyk/crit/compare/v0.5.0…v0.5.1

Contributors

2x 2x
v0.5.0

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

Documentation

E2E Tests

Contributors

JonnyCBB JonnyCBB TickTockBent TickTockBent vereis vereis
v0.4.8

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

v0.4.7

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

v0.4.6

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

v0.4.5

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

v0.4.4

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

v0.4.1

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

Web

GitHub →
v0.1.1

What’s Changed

Docs

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

v0.1.0

Initial open source release

The hosted share target for crit — share code reviews with a link.

Features

  • Share reviews from the crit CLI
  • Review page with inline comments, keyboard shortcuts, file tree, theme switching
  • Multi-file review support
  • Comment creation, editing, and deletion with author identity
  • Table of contents for markdown documents
  • Auto-expiring reviews (30 days of inactivity)

Self-hosting

  • Docker image published to GHCR (ghcr.io/tomasz-tomczyk/crit-web:0.1.0)
  • Auto-migrations on container startup
  • Configurable SSL, URL scheme, and port for reverse proxy setups
  • Health check endpoint at /health
  • Example docker-compose in contrib/

See the README for setup instructions.