docs: update CLI install docs for alias-first resolution

Document that `openboot install <word>` resolves aliases first before
falling back to username/default. Update cli-reference, config-options,
and custom-configs docs.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: fullstackjam

src/docs/cli-reference.md

@@ -29,15 +29,27 @@ openboot --preset developer
 
 You can still customize in the TUI. To skip the TUI entirely, add `--silent`.
 
-### `openboot install <username>/<slug>`
+### `openboot install <alias>` or `openboot install <username>/<slug>`
 
-Install from a custom config hosted on openboot.dev.
+Install from a config hosted on openboot.dev.
+
+If you set an alias for your config in the dashboard, use it directly:
+
+```
+openboot install myalias
+```
+
+Or use the full username/slug format:
 
 ```
 openboot install sarah/frontend-team
 ```
 
-Alternatively, use the `--user` flag: `openboot --user sarah/frontend-team` (same effect).
+**Resolution order** for a single word (no `/`):
+1. Try as a config alias (set in the dashboard)
+2. Fall back to `username/default` config
+
+Alternatively, use the `--user` flag: `openboot --user myalias` (same effect).
 
 For private configs, run `openboot login` first — the CLI sends your auth token automatically.
 
@@ -46,7 +58,7 @@ For private configs, run `openboot login` first — the CLI sends your auth toke
 | Flag | Description |
 |------|-------------|
 | `-p, --preset <name>` | Use a preset: `minimal`, `developer`, `full` |
-| `-u, --user <username/slug>` | Install from a config hosted on openboot.dev |
+| `-u, --user <alias or username/slug>` | Install from a config hosted on openboot.dev |
 | `-s, --silent` | Non-interactive mode — no TUI, no prompts |
 | `--dry-run` | Preview what would be installed without installing |
 | `--packages-only` | Install packages only, skip shell/macOS/dotfiles config |

src/docs/config-options.md

@@ -103,7 +103,9 @@ Snapshot data attached to this config (auto-populated when creating from `openbo
 
 ### `alias`
 
-Short URL alias for easy sharing. If set, the config is accessible with a shorter command — for example, `openboot install my-setup` instead of `openboot install username/slug`.
+Short URL alias for easy sharing. If set, this alias becomes the primary way to install the config — for example, `openboot install my-setup` instead of `openboot install username/slug`. The alias also works as a short URL: `openboot.dev/my-setup`.
+
+When a user runs `openboot install <word>`, the CLI checks aliases first before falling back to `username/default`.
 
 - **Type:** string
 - **Required:** no

src/docs/custom-configs.md

@@ -115,12 +115,18 @@ openboot login
 openboot install yourname/my-setup
 ```
 
-## Short URLs
+## Aliases & Short URLs
 
-Config slugs are auto-generated, but you can edit them in the dashboard. Keep them short:
+Set an alias in the dashboard to get a short install command and URL:
+
+- `openboot install myalias` instead of `openboot install yourname/my-long-slug`
+- `openboot.dev/myalias` instead of `openboot.dev/yourname/my-long-slug`
+
+Aliases must be unique across all configs. When a user runs `openboot install <word>`, the CLI resolves aliases first.
+
+You can also shorten your config slugs in the dashboard:
 
 - `openboot.dev/yourname/ios` instead of `openboot.dev/yourname/ios-development-team-2024`
-- `openboot.dev/yourname/ml` instead of `openboot.dev/yourname/machine-learning-setup`
 
 ## Install Tracking