Skip to content

Commit 5ce0117

Browse files
docs: add uninstall guide to FAQ and complete file locations in env-vars
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
1 parent d08977d commit 5ce0117

File tree

2 files changed

+45
-1
lines changed

2 files changed

+45
-1
lines changed

src/docs/env-vars.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,11 @@ These aren't environment variables, but useful to know:
7575

7676
| Path | What's There |
7777
|------|-------------|
78-
| `~/.openboot/bin/openboot` | The OpenBoot binary |
78+
| `~/.openboot/bin/openboot` | The OpenBoot binary (one-line installer only) |
7979
| `~/.openboot/auth.json` | Auth token (after `openboot login` or snapshot upload) |
8080
| `~/.openboot/snapshot.json` | Local snapshot (when using `--local`) |
81+
| `~/.openboot/config.json` | Auto-update settings |
82+
| `~/.openboot/install_state.json` | Tracks what was installed and when |
83+
| `~/.openboot/state.json` | UI reminder state |
84+
| `~/.openboot/update_state.json` | Auto-update check state |
8185
| `~/.dotfiles/` | Cloned dotfiles repo (when configured) |

src/docs/faq.md

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,46 @@ Or re-run the install script — it downloads the latest binary and replaces the
8181

8282
Your configs, snapshots, and auth tokens are unaffected by updates.
8383

84+
## How do I uninstall OpenBoot?
85+
86+
### 1. Remove the binary
87+
88+
**If installed via Homebrew:**
89+
90+
```bash
91+
brew uninstall openboot
92+
brew untap openbootdotdev/tap
93+
```
94+
95+
**If installed via the one-line installer:**
96+
97+
```bash
98+
rm -f ~/.openboot/bin/openboot
99+
```
100+
101+
### 2. Remove OpenBoot data
102+
103+
```bash
104+
rm -rf ~/.openboot
105+
```
106+
107+
This deletes your auth token, local snapshots, install state, and update config. If you want to keep anything, back it up first — see [File Locations](/docs/env-vars#file-locations) for what's in there.
108+
109+
### 3. Clean up shell config (optional)
110+
111+
If OpenBoot configured your shell, open `~/.zshrc` and remove the block starting with `# OpenBoot additions` — it includes Homebrew init, PATH changes, CLI aliases, and tool integrations. If you're not sure which lines, look for the block between `# OpenBoot additions` and the next blank line or section.
112+
113+
If you used dotfiles linking, OpenBoot created `.openboot.bak` backups of your original files. To restore them:
114+
115+
```bash
116+
# Example: restore a backed-up .zshrc
117+
mv ~/.zshrc.openboot.bak ~/.zshrc
118+
```
119+
120+
### 4. Packages and apps (optional)
121+
122+
OpenBoot doesn't remove Homebrew packages or casks when you uninstall it — they're yours to keep. If you want to remove packages that were installed via OpenBoot, use `brew uninstall <package>` individually.
123+
84124
## Where is my data stored?
85125

86126
| What | Where |

0 commit comments

Comments
 (0)