Skip to content

Turn caret off

Audience: anyone who wants caret to stop starting at login, or to remove it.

Two commands turn off different amounts of caret:

Command What it does
caret install, answering I'll run it myself Stops caret starting at login. Your agent still reaches caret, which starts on demand.
caret install --uninstall Removes caret from every agent host, and from this machine.

Stop caret starting at login

Run caret install and answer I'll run it myself. That removes the background service caret install set up, so the review page is no longer up from login onward. The install then prints how to bring the review page up by hand: caret serve keeps it up until you stop it with ctrl+c (see Run caret yourself).

The choice isn't saved anywhere, so a later caret install at a terminal asks again. Without a terminal, caret install can't ask, so it leaves things as they are: it refreshes the service if one is registered, and adds none otherwise.

Remove caret

Run the command in Remove caret.

Besides removing caret from the agent hosts, --uninstall removes the service's unit file, the launcher that starts it, the records the launcher reads, and caret's own copies under ~/.local/state/caret/roots/. It keeps your reviews. The launcher removes the same things itself once it finds no caret installed anywhere, its own copies included.

--uninstall also removes the menubar app and the macOS file that starts it at login. So does the launcher when it cleans up on its own.

To remove only the menubar app, run caret install and answer No to its question (see Show caret in the menu bar).

If macOS Login Items shows caret

Warning

On macOS caret also appears under System Settings → Login Items. Turning it off there does not turn caret off for caret install, because caret cannot read that switch. A later caret install that keeps caret running registers the service again and reports success while the switch still reads off. Turn caret off with caret install, answering I'll run it myself, or with --uninstall instead.

Next steps