Setup Shortcuts
Idempotently installs shell shortcuts into ~/.zshrc and drops the bundled
audio assets in place. Safe to re-run — each block checks its own marker
and skips if already present.
Run it
zsh scripts/install.sh
Then source ~/.zshrc (the script prints this reminder).
What it installs
- claude-code-launchers —
c/cc/ccc (sonnet/opus/fable) plus the
full model x effort grid (cl, cm, ch, cxh, cmx, ccl...cccmx, ccu).
- cloud-auth —
g (gcloud auth login), a (ant auth login), ga
(gcloud application-default login), sl (slack login).
- cg — jump to a project dir via a
PROJECT_DIRS map, falling back to
a fuzzy find under ~/code. Edit the map in the installed block for a
new machine's paths.
- caf —
caffeinate -d toggle with a 24h cap; caf off stops it.
- dev-tool-aliases —
ca (cursor-agent, composer-2.5), cx (codex),
s (sf org login, my-org-prod).
- sound-toggles —
bn (brown noise, 20s fade in / 1s fade out),
lenny (Lenny Kravitz — It Ain't Over 'Til It's Over, resumable), the
shared _track/_audio_gain helpers lenny depends on, and silence
(kill whatever's playing). Audio files ship in assets/ and get copied
to ~/.brownnoise.wav, ~/.bn-tail.wav, and
~/Music/tracks/Lenny Kravitz - It Ain't Over 'Til It's Over (Official Music Video).wav
if not already there.
Requirements
install.sh preflight-checks these and prints what's missing (it still
installs the aliases/functions either way — they just won't run until the
binary exists):
| binary |
needed by |
install |
claude |
claude-code-launchers |
official installer, see claude.com/code |
gcloud |
g, ga |
brew install --cask google-cloud-sdk |
slack |
sl |
brew install slack-cli |
cursor-agent |
ca |
official installer, see cursor.com |
codex |
cx |
npm install -g @openai/codex |
sf |
s |
npm install -g @salesforce/cli |
sox (provides play) |
bn, lenny |
brew install sox |
caffeinate |
caf |
built into macOS, nothing to install |
Not checked: ant, needed by a. On this machine ant on $PATH
resolves to Apache Ant (the Java build tool), not an Anthropic CLI —
a="ant auth login" hangs rather than authenticating. Needs the real
Anthropic Platform CLI installed and ahead of Apache Ant on PATH before
a is usable; left unfixed here since the right binary/install path
wasn't confirmed.
Notes
- Known broken and deliberately left out:
mmd (mermaid→PNG) — mmdc
needs Puppeteer's headless Chrome, which isn't installed, so it fails
before it ever gets to rendering.
- Re-running only fills in missing blocks; it never touches ones already
present, so hand edits to an installed block survive.
1---2name: setup-shortcuts3description: Installs a personal set of shell aliases/functions (Claude Code launcher shortcuts, cloud/tool auth, project-jump, caffeinate toggle, dev-tool CLIs, and two sound toggles) into ~/.zshrc, bundling the audio files the sound toggles need. Use when the user says "set up shortcuts", "setup shortcuts", "/setup-shortcuts", or wants these shell shortcuts installed/reinstalled on a machine.4---56# Setup Shortcuts78Idempotently installs shell shortcuts into `~/.zshrc` and drops the bundled9audio assets in place. Safe to re-run — each block checks its own marker10and skips if already present.1112## Run it1314```15zsh scripts/install.sh16```1718Then `source ~/.zshrc` (the script prints this reminder).1920## What it installs2122- **claude-code-launchers** — `c`/`cc`/`ccc` (sonnet/opus/fable) plus the23 full model x effort grid (`cl`, `cm`, `ch`, `cxh`, `cmx`, `ccl`...`cccmx`, `ccu`).24- **cloud-auth** — `g` (gcloud auth login), `a` (ant auth login), `ga`25 (gcloud application-default login), `sl` (slack login).26- **cg** — jump to a project dir via a `PROJECT_DIRS` map, falling back to27 a fuzzy find under `~/code`. Edit the map in the installed block for a28 new machine's paths.29- **caf** — `caffeinate -d` toggle with a 24h cap; `caf off` stops it.30- **dev-tool-aliases** — `ca` (cursor-agent, composer-2.5), `cx` (codex),31 `s` (sf org login, my-org-prod).32- **sound-toggles** — `bn` (brown noise, 20s fade in / 1s fade out),33 `lenny` (Lenny Kravitz — It Ain't Over 'Til It's Over, resumable), the34 shared `_track`/`_audio_gain` helpers `lenny` depends on, and `silence`35 (kill whatever's playing). Audio files ship in `assets/` and get copied36 to `~/.brownnoise.wav`, `~/.bn-tail.wav`, and37 `~/Music/tracks/Lenny Kravitz - It Ain't Over 'Til It's Over (Official Music Video).wav`38 if not already there.3940## Requirements4142`install.sh` preflight-checks these and prints what's missing (it still43installs the aliases/functions either way — they just won't run until the44binary exists):4546| binary | needed by | install |47|---|---|---|48| `claude` | claude-code-launchers | official installer, see claude.com/code |49| `gcloud` | `g`, `ga` | `brew install --cask google-cloud-sdk` |50| `slack` | `sl` | `brew install slack-cli` |51| `cursor-agent` | `ca` | official installer, see cursor.com |52| `codex` | `cx` | `npm install -g @openai/codex` |53| `sf` | `s` | `npm install -g @salesforce/cli` |54| `sox` (provides `play`) | `bn`, `lenny` | `brew install sox` |55| `caffeinate` | `caf` | built into macOS, nothing to install |5657Not checked: `ant`, needed by `a`. On this machine `ant` on `$PATH`58resolves to Apache Ant (the Java build tool), not an Anthropic CLI —59`a="ant auth login"` hangs rather than authenticating. Needs the real60Anthropic Platform CLI installed and ahead of Apache Ant on `PATH` before61`a` is usable; left unfixed here since the right binary/install path62wasn't confirmed.6364## Notes6566- Known broken and deliberately left out: `mmd` (mermaid→PNG) — `mmdc`67 needs Puppeteer's headless Chrome, which isn't installed, so it fails68 before it ever gets to rendering.69- Re-running only fills in missing blocks; it never touches ones already70 present, so hand edits to an installed block survive.
seanx10m