startrek-beeps

startrek-beeps for Claude Code

LCARS-style Star Trek computer sounds for Claude Code, bound to session and tool-call lifecycle events. Work with Claude like you're operating a console on the Enterprise.

Platform: macOS only (uses built-in afplay). Linux / Windows support is a future addition — PRs welcome.

What it does

Seven hook events each get a semantically-appropriate LCARS beep:

Event	Sound	When it fires
SessionStart	alert (13)	New Claude Code session opens
UserPromptSubmit	tap (07)	You submit a prompt — command received
Notification	alert (13)	Permission prompt / attention needed
PreToolUse (Bash)	mode-switch (03)	Destructive command detected1
Stop	confirm (08)	Claude finishes responding
SubagentStop	deactivate (14)	A subagent finishes
PreCompact	mode-switch (03)	Context compaction runs

Install

Option A — add this repo as a marketplace and install via /plugin

# In any Claude Code session:
/plugin marketplace add thijs-hakkenberg/startrek-beeps-claude-code
/plugin install startrek-beeps@startrek-beeps

Option B — clone locally and point Claude Code at the directory

git clone [email protected]:thijs-hakkenberg/startrek-beeps-claude-code.git ~/.claude/plugins/startrek-beeps
# then enable via /plugin or in your settings.json enabledPlugins

Uninstall / disable

/plugin disable startrek-beeps@startrek-beeps

Or silence just one event: edit hooks/hooks.json and remove that block.

Migrating from hand-wired hooks

If you previously wired these sounds directly into ~/.claude/settings.json and ~/.claude/hooks/lcars-*.sh, remove those once the plugin is installed — otherwise every sound plays twice. Remove:

• the SessionStart, UserPromptSubmit, Notification, PreToolUse (Bash matcher only, not your other PreToolUse hooks), Stop, SubagentStop, and PreCompact entries from ~/.claude/settings.json hooks
• ~/.claude/hooks/lcars-play.sh and ~/.claude/hooks/lcars-destructive.sh
• ~/.claude/sounds/*.wav (only if you want — bundled in plugin now)

Sounds

All six .wav files in sounds/ are converted from the original .ogg LCARS sounds shipped in the App.SOTA.TTSDemo repo (src/lib/sounds/ + public/sounds/). They are short UI beeps derived from public Star Trek sound samples.

Layout

startrek-beeps-claude-code/
├── .claude-plugin/
│   ├── plugin.json         # plugin manifest
│   └── marketplace.json    # so this repo can also act as a marketplace
├── hooks/hooks.json        # 7 hook entries, all using ${CLAUDE_PLUGIN_ROOT}
├── scripts/
│   ├── lcars-play.sh       # non-blocking afplay wrapper
│   └── lcars-destructive.sh # inspects Bash cmd for dangerous patterns
└── sounds/*.wav            # 6 LCARS beeps

License

MIT — see LICENSE.

Footnotes

1. Only fires on matches for rm -rf, git reset --hard, git push -f, git branch -D, drop table/drop database, shutdown, reboot. Regular Bash commands are silent. ↩