You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Replace marketing-heavy language with genuine, conversational tone
- Emphasize real problems solved (two-hour setup ritual) over features
- Simplify feature descriptions to be more human-friendly
- Improve readability with shorter, punchier sentences
- Update section headers to be more approachable (Why This Exists vs Why OpenBoot)
- Streamline comparison table and preset descriptions
Brewfiles are manual YAML editing. Nix has a brutal learning curve. Dotfile repos become unmaintainable after six months.
59
61
60
-
Other tools make you write YAML, learn Nix, or manage dotfile repos. OpenBoot gives you a visual TUI to pick packages, a web dashboard to manage configs, and shareable URLs so your whole team runs one command.
62
+
I wanted something simple: a visual way to pick packages, a dashboard to manage configs without touching files, and URLs you can share. One command, same environment for everyone on your team.
61
63
62
64
|| OpenBoot | Brewfile | chezmoi | nix-darwin |
63
65
|---|:---:|:---:|:---:|:---:|
@@ -69,69 +71,69 @@ Other tools make you write YAML, learn Nix, or manage dotfile repos. OpenBoot gi
69
71
70
72
## What It Does
71
73
72
-
-**Homebrew packages & GUI apps** — Docker, VS Code, Chrome, Warp, and more
73
-
-**Dotfiles** — Clone your repo, deploy with GNU Stow, or skip
74
-
-**Shell setup** — Oh-My-Zsh with sensible aliases
Not sure? Pick **developer** and toggle what you don't need.
102
+
Most people start with **developer** and uncheck what they don't need.
101
103
102
104
## Snapshot
103
105
104
-
Already set up? Capture your environment and share it.
106
+
Already have a Mac set up the way you like? Save it.
105
107
106
108
```bash
107
109
openboot snapshot
108
110
```
109
111
110
-
Captures Homebrew packages, macOS preferences, shell config (Oh-My-Zsh theme & plugins), and git settings. Upload to [openboot.dev](https://openboot.dev) for a shareable install URL, or save locally with `--local`.
112
+
This captures everything: Homebrew packages, macOS settings, shell config, git identity. Upload it to [openboot.dev](https://openboot.dev) for a shareable URL, or save it locally with `--local`.
111
113
112
-
Restoring from a snapshot now fully restores your environment — packages, git identity, shell theme, and plugins. [Learn more →](https://openboot.dev/docs/snapshot)
114
+
When you restore a snapshot, you get everything back exactly as it was. [Docs →](https://openboot.dev/docs/snapshot)
113
115
114
116
### Clean
115
117
116
-
Drifted from your config? Remove extra packages.
118
+
Installed too much? Clean up what's not in your config.
117
119
118
120
```bash
119
121
openboot clean # Compare against local snapshot
120
122
openboot clean --user yourname # Compare against cloud config
121
123
openboot clean --from my-setup.json # Compare against a snapshot file
122
-
openboot clean --dry-run #Preview what would be removed
124
+
openboot clean --dry-run #See what would be removed
123
125
```
124
126
125
127
## For Teams
126
128
127
-
New developer joins → runs one command → ready to code. [Full guide →](https://openboot.dev/docs/teams)
129
+
New hire runs one command, gets the same environment as everyone else. [Guide →](https://openboot.dev/docs/teams)
128
130
129
131
```bash
130
132
brew install openbootdotdev/tap/openboot
131
133
openboot --user yourteam/frontend
132
134
```
133
135
134
-
Create configs on the [dashboard](https://openboot.dev/dashboard), share the install command in your onboarding docs. Stack changes? Update the config — the command stays the same.
136
+
Make your config on the [dashboard](https://openboot.dev/dashboard), put this in your onboarding docs. When your stack changes, update the config. The install command stays the same.
135
137
136
138
## Advanced Usage
137
139
@@ -204,14 +206,14 @@ openboot version # Print version
204
206
205
207
## FAQ
206
208
207
-
**Do I need anything installed first?**
208
-
Just macOS 12.0+ and Homebrew. The one-line installer handles Homebrew for you if needed.
209
+
**Do I need anything installed first?**
210
+
macOS 12.0 or newer. Homebrew if you have it, but the installer will get it for you if not.
209
211
210
-
**What if I already have some tools?**
211
-
OpenBoot detects them and skips reinstalling.
212
+
**What if I already have some of these tools?**
213
+
It checks what's installed and skips anything you already have.
212
214
213
-
**Is my data tracked?**
214
-
No. Zero telemetry, zero analytics. Fully open source.
215
+
**Is my data tracked?**
216
+
No. No telemetry, no analytics. Code is open source, check for yourself.
215
217
216
218
---
217
219
@@ -221,7 +223,7 @@ No. Zero telemetry, zero analytics. Fully open source.
221
223
222
224
## Contributing
223
225
224
-
Found a bug or want a feature? [Open an issue](https://github.com/openbootdotdev/openboot/issues) or submit a PR.
226
+
Bug reports and feature requests: [open an issue](https://github.com/openbootdotdev/openboot/issues). Pull requests welcome.
0 commit comments