Skip to content

Releases

v1.11.1

Choose a tag to compare

@macintacos macintacos released this 19 Nov 22:41
Immutable release. Only release title and notes can be modified.
5d49fad

caret 1.11.1 fixes two bugs: a plan review that was rejected at once when the agent outlived the directory it started in, and a menubar app that caret install --refresh could fail to reload.

Fixed

  • A plan review no longer comes back as "changes requested" before anyone looks at it when the agent's session started in a directory that has since been deleted, such as a removed worktree. caret now starts the review from /, so the review opens in the browser as usual. This covers Claude Code, OpenCode and pi alike.
  • caret install --refresh reloads a running menubar app instead of failing with launchctl bootstrap failed (5): Input/output error. caret now waits for launchd to finish removing the old app before it starts the new one, and the background service install does the same.

Full Changelog: v1.11.0...v1.11.1

v1.11.0

Choose a tag to compare

@macintacos macintacos released this 19 Nov 15:09
Immutable release. Only release title and notes can be modified.
c8bd8df

caret 1.11.0 adds a menubar app for macOS: a carrot that colours in while a plan waits for review and opens on a card of your review stats. It also lets the Vim keys stop on comments and act on them, renders markdown in the review title and breadcrumbs, and publishes the docs as a site at macintacos.github.io/caret.

The caret carrot in the macOS menu bar fades from grey to orange as a plan arrives, its menu opens on a card of review stats, and the carrot fades back to grey once the plan is reviewed

Added

  • A menubar app for macOS 13 or later. caret install asks whether to show caret in the menu bar, and the answer defaults to yes. A LaunchAgent starts the app at login and relaunches it after a crash, and Quit keeps it closed until the next login. caret install --uninstall removes it, and so does caret's own cleanup once caret is gone from every agent host. See Show caret in the menu bar.
  • The carrot colours in while a plan waits for review and greys out once none does. It fades between the two and grows a little as a plan arrives; with Reduce motion on, it switches at once.
  • The carrot's menu opens on a card of your review stats: the running caret's version, plans approved and rejected, revisions, and comments. The card takes the accent of your review page's theme, and Open caret sits below it.
  • Comments are stops for the Vim keys. j/k stop on each comment card and unsent draft in the source view and the preview, and ]c/[c jump between comments. The comment under the cursor takes keys of its own: e edits, h/l fold, Shift+D discards after a confirm, c adds to its thread, and V selects from its last line.
  • A documentation site at macintacos.github.io/caret, with a tutorial, how-to guides, reference and explanation pages, a glossary, and a changelog of every release.

Changed

  • The top bar and the plan's breadcrumbs render inline markdown in titles and headings (bold, italics, code and strikethrough) instead of showing the raw syntax.
  • In the preview, a file the plan cites reads as inline code whether or not the agent put it in backticks.
  • The theme JSON Schema moved to https://raw.githubusercontent.com/macintacos/caret/HEAD/docs/theme.schema.json, and its old doc/ URL now returns 404. Update the $schema line in your theme files: caret still loads a file that keeps the old line, but your editor stops completing and validating it.

Fixed

  • A caret built from source can tell how far behind main it is again. Its update check and What's new compared against trunk, which stopped resolving when the default branch was renamed to main; they now compare against HEAD.
  • The file preview's left edge and its shade run unbroken past the line numbers, which used to paint over them.
  • A daemon lock naming pid 0 no longer reads as a running daemon, so caret can't signal its own process group while retiring one.

Full Changelog: v1.10.1...v1.11.0

v1.10.1

Choose a tag to compare

@macintacos macintacos released this 12 Nov 20:51
Immutable release. Only release title and notes can be modified.
48d2334

caret 1.10.1 adds a hover to OpenCode's pending-plan line and stops a source-view image that fails to load from shifting the lines around it.

Changed

  • On OpenCode, pointing at the pending-plan line above the prompt turns its open in browser hint bold in the theme's action colour, the way OpenCode's own toasts mark their action.

Fixed

  • A plan image in the source view takes up room only once it has loaded, so one that fails to load no longer shifts the lines around it, including the line an open comment is on.

Full Changelog: v1.10.0...v1.10.1

v1.10.0

Choose a tag to compare

@macintacos macintacos released this 12 Nov 16:21
Immutable release. Only release title and notes can be modified.
aca1cac

caret 1.10.0 replaces the three slash commands with a single /caret on Claude Code, OpenCode and pi: /caret <description> plans, /caret doctor runs the report, and /caret demo runs the demo. The old /caret:plan, /caret:doctor and /caret:demo are gone with no aliases, and a bare /caret no longer opens the waiting review.

Changed

  • One argument-routed /caret replaces the three per-host commands:

    Before Now
    /caret:plan <description> /caret <description> (or /caret plan <description>)
    /caret:doctor /caret doctor
    /caret:demo /caret demo
    /caret to open the waiting review <leader>p (OpenCode v2) or ctrl+alt+o (pi)
    blank /caret:plan in pi to leave planning /caret plan
  • A bare /caret prints a usage hint.

  • In Claude Code the command is listed as caret:caret with the argument hint [what you want done] | doctor | demo; a typed /caret resolves to it.

  • In pi, typing /caret offers plan, doctor and demo as completions.

  • On OpenCode, /caret doctor and a bare /caret leave the session on the plan agent, because one command file carries one agent: key. The command says so and how to switch back.

  • caret install on OpenCode removes the caret:*.md command files older versions left behind, leaving your own command files alone.

Removed

  • A blank /caret:plan no longer plans what you asked earlier in the session.

Fixed

  • A plan breadcrumb level that came back while it was animating out could stay invisible, leaving a hole where it belonged.

Full Changelog: v1.9.0...v1.10.0

v1.9.0

Choose a tag to compare

@macintacos macintacos released this 11 Nov 01:12
Immutable release. Only release title and notes can be modified.
4bb1eff

caret 1.9.0 adds pi as a third host beside Claude Code and OpenCode: caret install sets it up, /caret:plan puts pi's agent in a planning mode that routes its plan to caret for review, and a notice above the editor flags a waiting review. It also opens every plan in the rendered preview, with the source one s away.

Added

  • pi support. caret install now offers pi (1.5.0 or later) alongside Claude Code and OpenCode. It installs, updates, and removes caret through pi's own package commands, leaves a pinned entry alone, and keeps pi to one caret entry.
  • caret_review_plan in pi. pi's agent submits an inline or .md plan and waits for your decision; approvals, approval notes, and change requests reach the model as the tool result. Esc cancels a waiting review, and a review caret could not run tells the model to stop and tell you instead of reading as a change request.
  • /caret:plan [task] in pi. pi has no plan mode of its own, so this adds one: the agent writes its plan under pi's plans/ folder and submits it to caret, and edit and write calls outside that folder are blocked until you approve the plan. Planning survives /reload and resume.
  • A pending-plan notice in pi. While a review waits, pi shows a one-row notice above the editor and a caret footer status. Click the notice, run /caret, or press ctrl+alt+o to reopen the review in the browser. The shortcut needs Option to act as Alt/Meta in Terminal.app and iTerm2.
  • /caret:demo and /caret:doctor in pi. The demo walks a new user through a review end to end; doctor puts its verdict and report in pi's transcript without sending them to the model.
  • pi checks in caret doctor. When pi's settings list caret, doctor adds pi-host (a missing or too-old pi), pi-caret-entry (caret listed twice, filtered out, or missing its package), and pi-caret-version (an npm caret behind the published one).
  • pi skills in / completion. A review opened from pi offers your pi skills as /skill:<name> in the comment editor.

Changed

  • Plans open in the rendered preview. The view toggle beside Versions is now a Source button on s; p no longer toggles the plan view. A browser that used caret before is moved to preview once, with a one-time popover on the Source button pointing the way back. Your choice still persists per browser.
  • caret doctor starts its adapter checks before its daemon health probe, so a slow host version check no longer times the probe out.

Full Changelog: v1.8.1...v1.9.0

v1.8.1

Choose a tag to compare

@macintacos macintacos released this 09 Nov 19:06
Immutable release. Only release title and notes can be modified.
96a965a

caret 1.8.1 adds vim's zz, zt and zb to scroll the plan around the cursor, ]] and [[ to jump between changes in compare, and lets a hook attach to a caret daemon on another machine, so you can review a server's plans from another device. It also keeps a tall row such as an inline image on screen when j/k lands on it.

Added

  • Scroll around the cursor with zz, zt and zb. On both the source view and the preview, they scroll the cursor line to the center, or to the top or bottom edge of the band the j/k follow keeps, without moving the cursor or a visual selection. With no cursor placed, each first reveals one at the reading position. A row too tall for that margin, such as an inline image, is centered instead, and near the end of the plan the scroll glides to rest at the end of its range. The ? help lists them.
  • Jump between changes in compare. In the compare-versions view, ]] and [[ step forward and back through the changes, scrolling each to just below the pinned file header. A stop is a run of changed lines, not a whole hunk, so separate edits in one hunk each get their own. The jump stops at either end instead of wrapping, and holding the key advances one change per press. Off compare, the keys still jump between headings.
  • Review on another machine's daemon. A hook whose daemon.host is not an address on its own machine now attaches to the caret daemon there, instead of refusing because the state-directory paths differ. It never retires, restarts or spawns that daemon, whatever version each side runs, and denies the review with no caret daemon is answering at … when nothing answers. doc/RUNNING.md covers the setup, the cleartext token, and the limits of a daemon acting on the server's files.

Fixed

  • j/k onto a tall row keeps it on screen. Moving the cursor onto a row taller than the follow's margin, such as an inline image, centers it instead of scrolling it off screen.

Full Changelog: v1.8.0...v1.8.1

v1.8.0

Choose a tag to compare

@macintacos macintacos released this 05 Nov 23:33
Immutable release. Only release title and notes can be modified.
a20b2fe

caret 1.8.0 adds Approve & build for OpenCode v2, which approves a plan and switches the session from plan to build in the same turn, and lets you open a waiting plan from inside OpenCode: /caret, ctrl+x p, a card above the prompt, or the review toasts. It also rewraps the plan preview to fit a narrowed pane instead of scrolling it sideways, and raises the OpenCode v2 floor to 2.0.29.

Added

  • Approve & build on OpenCode v2. A review sent from v2's plan agent offers a second approve option, Approve & build, which approves the plan and switches the session to the build agent, so implementation starts in the same turn. Plain Approve stays the default and leaves the session in plan; once you pick Approve & build, the browser remembers it for later v2 reviews. If the switch fails, the plan stays approved and the agent is told the session is still in plan. OpenCode v1 reviews, and v2 reviews from any other agent, show a single Approve.
  • Open the waiting plan from OpenCode v2. /caret, a command-palette entry, or ctrl+x p (rebindable as caret.open) opens the plan waiting in the current session in your browser, and the palette suggests it while a plan waits. Off a session it opens caret's home page. If caret can't start, a "caret: open failed" toast points at caret doctor.
  • A pending-plan card above the prompt. On OpenCode v2, the session a plan waits in shows a card above its prompt, ^caret plan waiting for your review, with the open key and "open in browser" on the right. A click opens the review, and approving, denying or cancelling clears it. It takes its colours from the OpenCode theme, and other sessions show nothing. A terminal started or reattached after the plan arrived doesn't show it.
  • Toasts open the waiting session. On OpenCode v2, the "review this plan" toast and the decision toast after it offer to open the session the plan waits in when you're looking at a different one.

Changed

  • The plan preview rewraps to fit. Beside a file docked on the right or in a narrow window, the preview's text rewraps to the pane instead of scrolling the plan sideways, and the line at the top stays put through a resize. Wide tables and code blocks still scroll in their own box, and comments stay on their lines.
  • The outline column stays beside a docked file instead of folding away. Shift+\ and the header's outline button show or hide the column, and \ focuses its filter, or opens the outline popup while the column is hidden or the window is under 960px.
  • OpenCode v2 needs 2.0.29 or later. On v2 2.0.18–2.0.28, caret still loads but refuses every path review with a message naming 2.0.29, and caret doctor's opencode-host check fails with an upgrade remedy. Inline plan reviews still work. The v1 floor stays at 1.3.4.
  • Plan formatting uses rumdl 0.3.2, which caret downloads on first use after the upgrade. It keeps the indentation inside a multiline code span after a bare list marker, and may add a blank line between a heading and a list or code block directly under it.

Removed

  • Compare's outline. Compare has no outline, so its changed-sections popup is gone and \ and Shift+\ do nothing there.

Full Changelog: v1.7.1...v1.8.0

v1.7.1

Choose a tag to compare

@macintacos macintacos released this 04 Nov 22:41
Immutable release. Only release title and notes can be modified.
3497fe8

caret 1.7.1 rebuilds the waiting room around a lit ^ key that turns the carrot fact, with a stamp that reads "listening" or "offline". It also smooths the hand-off into and out of a plan, which no longer stutters, and a page opened on a pending plan no longer flashes the waiting room first.

Changed

  • The waiting room's ^ is a lit key. It is a rubber key set in a bed, its legend lit in the accent with a slow breathing glow. A click or the ^ shortcut turns the carrot fact, plays the tap sound and restarts the timer. Offline, the key sits down and its legend goes dark; if the key held focus, focus moves to the heading.
  • A listening stamp. The waiting room's hint is a stamp with the status bar's LED that reads "listening" or "offline", and announces the change.
  • Waiting room copy. Connected, it reads "When an agent proposes a plan, it opens here." Offline, it says the page reconnects on its own once the daemon is running.

Fixed

  • The plan hand-off. Going to a plan and back crossfades without a stall, and the two views no longer dip through the background.
  • Opening on a pending plan shows the plan straight away, with no flash of the waiting room first.

Full Changelog: v1.7.0...v1.7.1

v1.7.0

Choose a tag to compare

@macintacos macintacos released this 03 Nov 22:28
Immutable release. Only release title and notes can be modified.
5ba4f88

caret 1.7.0 moves the outline out of its popover into a resizable column beside the plan, where resting on a row previews its section, under a new plan header that holds the breadcrumbs, Search, Versions and Preview. It also gives the review UI a tactile finish: buttons sink when pressed or triggered by their shortcut, the plan sits in a recessed pane, and Settings and search are rebuilt to match.

Added

  • An outline column beside the plan. The outline stands as a column left of the plan, resizable from its right edge between 12rem and 30rem. The arrow keys step a focused edge, a double-click resets it, and the width is remembered. Under 960px wide, or beside an open file, it drops from the Outline key as a float instead. While comparing, the column folds away and the key opens a float of the changed sections.
  • Section previews from the outline. Resting on an outline row, under the pointer or the arrow keys, shows that section beside the outline, taken from the source view or Preview. It never covers an open file.
  • A plan header. A header above the plan holds the breadcrumbs, a Search entry, Versions and Preview. The Search entry replaces the "/ to search" hint and is a button, so it stays usable with shortcut hints off.

Changed

  • A tactile finish. Buttons are domed caps set in inset wells that sink when pressed, and a keyboard shortcut plays the same press on its button. Modals, menus and popovers float on layered shadows and share one 14px corner, and the plan's chips and code blocks are stamped or recessed into the page. The plan sits in a pane set into the window, whose edges shade while there is more to scroll. Keyboard focus looks like hover, with no focus ring.
  • Settings sets each section's rows in recessed groups, with a latching switch, a level-meter volume slider, and Advanced values as code blocks with copy and wrap.
  • Search. The find row slides out of the Search entry, and a committed query is stamped. The current match is an opaque mark, the strongest thing on the page in every theme, and every other match is a wash a step below it.
  • Unsent comments. Comments kept for later read as Unsent everywhere — under the line, in the outline's count, in Request changes and in the approve guard — in a tinted well with their own glyph. A saved comment can be marked unsent from Request changes.
  • Filter fields clear from an × inside the field, in the outline and the breadcrumb bar. The Clear button at the outline's foot is gone.
  • Labels and stamps such as Folder, Preview, In use and table headers are in sentence case. Shortcut keycaps stay in capitals.
  • The working directory sits centred on the status bar. A click still copies the full path.

Full Changelog: v1.6.0...v1.7.0

v1.6.0

Choose a tag to compare

@macintacos macintacos released this 29 Oct 16:09
Immutable release. Only release title and notes can be modified.
1bdc7a0

caret 1.6.0 adds OpenCode v2 support, so caret install now wires caret into OpenCode v2 as well as v1. It also opens What's new on its own after an upgrade, and shows the screenshots in release notes there.

Added

  • OpenCode v2 support. caret now loads on OpenCode v2 (2.0.18 and later) as well as v1 (1.3.4 and later). caret install writes it under v2's plugins entry, the plan agent offers caret_review_plan, and a plan opens in caret's review UI as it does on v1. In an attached v2 TUI, the review-link toast appears while a review is pending.
  • What's new after an upgrade. The first time the review UI loads after caret upgrades, What's new opens on its own, titled "Updated to caret X", with the notes for every release since the last version that browser saw, newest first. Closing it keeps it shut on reload. With [updates] check = false it makes no GitHub call and stays closed. Announcements start with the upgrade after this one, since an existing install has no record of the version it last saw.
  • Images in What's new. Release-note screenshots hosted on GitHub now show in What's new, scaled to the dialog's width. Images from anywhere else are still stripped.

Full Changelog: v1.5.0...v1.6.0