ReviewOS

also looking at this

stacks/uplink

docs: the documentation the README points at

#63
Merged glennmichael123 wants to merge docs/the-missing-docs into main
9 files +509 -10
docs/uninstall.mdadded+64-0
Changes to docs/uninstall.md
@@ -0,0 +1,64 @@
1# Uninstall
2
3One sequence per way of installing. Dragging the app to the Trash is not enough on its own: it
4leaves a LaunchAgent pointing at a binary that is no longer there, which launchd keeps trying to
5start.
6
7## The app
8
9**1. Quit it from the menubar.** That stops the watcher and releases its lock cleanly.
10
11**2. Remove the login item.**
12
13```bash
14launchctl bootout gui/$(id -u)/com.stacksjs.uplink 2>/dev/null
15rm -f ~/Library/LaunchAgents/com.stacksjs.uplink.plist
16```
17
18**3. Delete the app.**
19
20```bash
21rm -rf /Applications/Uplink.app
22```
23
24**4. Delete its data.** Conversations, runs, settings and the cached licence answer.
25
26```bash
27rm -rf ~/Library/Application\ Support/Uplink
28```
29
30**5. Delete the logs.**
31
32```bash
33rm -f ~/Library/Logs/Uplink.log ~/Library/Logs/Uplink.log.1
34```
35
36**6. Remove both Keychain items.** There are two, and only removing the first is the easy mistake.
37
38```bash
39security delete-generic-password -s com.stacksjs.uplink -a claude-oauth-token
40security delete-generic-password -s com.stacksjs.uplink -a license-key
41```
42
43**7. Revoke the permissions**, in System Settings, Privacy & Security: remove Uplink from Full Disk
44Access, and from Automation.
45
46## From source
47
48```bash
49./buddy uplink:uninstall
50```
51
52That stops the service and removes it from login. Then delete the clone, and follow steps 4 to 7
53above, with one difference: the from-source build's bundle id is `com.stacksjs.uplink.source`, so
54that is the name to look for in System Settings.
55
56`.env` holds your Claude Code token if you set one there rather than in the Keychain, so delete the
57clone rather than leaving it around.
58
59## Your licence
60
61Uninstalling does not cancel a subscription. Manage it from **Manage** in the menubar before you
62remove the app, or from the Stripe customer portal link in the email you got when you bought it.
63
64A lifetime licence has nothing to cancel, and the key keeps working if you install Uplink again.