Repository navigation
Releases
v1.11.1
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 --refreshreloads a running menubar app instead of failing withlaunchctl 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
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.
Added
- A menubar app for macOS 13 or later.
caret installasks 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 --uninstallremoves 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/kstop on each comment card and unsent draft in the source view and the preview, and]c/[cjump between comments. The comment under the cursor takes keys of its own:eedits,h/lfold,Shift+Ddiscards after a confirm,cadds to its thread, andVselects 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 olddoc/URL now returns 404. Update the$schemaline 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
mainit is again. Its update check and What's new compared againsttrunk, which stopped resolving when the default branch was renamed tomain; they now compare againstHEAD. - 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
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 browserhint 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
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
/caretreplaces the three per-host commands:Before Now /caret:plan <description>/caret <description>(or/caret plan <description>)/caret:doctor/caret doctor/caret:demo/caret demo/caretto open the waiting review<leader>p(OpenCode v2) orctrl+alt+o(pi)blank /caret:planin pi to leave planning/caret plan -
A bare
/caretprints a usage hint. -
In Claude Code the command is listed as
caret:caretwith the argument hint[what you want done] | doctor | demo; a typed/caretresolves to it. -
In pi, typing
/caretoffersplan,doctoranddemoas completions. -
On OpenCode,
/caret doctorand a bare/caretleave the session on theplanagent, because one command file carries oneagent:key. The command says so and how to switch back. -
caret installon OpenCode removes thecaret:*.mdcommand files older versions left behind, leaving your own command files alone.
Removed
- A blank
/caret:planno 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
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 installnow 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_planin pi. pi's agent submits an inline or.mdplan 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'splans/folder and submits it to caret, andeditandwritecalls outside that folder are blocked until you approve the plan. Planning survives/reloadand resume.- A pending-plan notice in pi. While a review waits, pi shows a one-row notice above the editor and a
caretfooter status. Click the notice, run/caret, or pressctrl+alt+oto reopen the review in the browser. The shortcut needs Option to act as Alt/Meta in Terminal.app and iTerm2. /caret:demoand/caret:doctorin 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 addspi-host(a missing or too-old pi),pi-caret-entry(caret listed twice, filtered out, or missing its package), andpi-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;pno 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 doctorstarts 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
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,ztandzb. 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 thej/kfollow 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.hostis 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 withno caret daemon is answering at …when nothing answers.doc/RUNNING.mdcovers the setup, the cleartext token, and the limits of a daemon acting on the server's files.
Fixed
j/konto 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
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
planagent offers a second approve option, Approve & build, which approves the plan and switches the session to thebuildagent, so implementation starts in the same turn. Plain Approve stays the default and leaves the session inplan; 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 inplan. 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, orctrl+x p(rebindable ascaret.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 atcaret 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
pathreview with a message naming 2.0.29, andcaret doctor'sopencode-hostcheck fails with an upgrade remedy. Inlineplanreviews 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
\andShift+\do nothing there.
Full Changelog: v1.7.1...v1.8.0
v1.7.1
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
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
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 installwrites it under v2'spluginsentry, theplanagent offerscaret_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 = falseit 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
