Tinycast

Tinycast is the launcher. It has no text config; scripts/tinycast-setup.sh is the source of truth for hotkeys, Quick Action prompts, and Custom Commands.

make stow-bin
./scripts/macos-deps.sh
make setup-tinycast

setup-tinycast quits Tinycast, writes com.tinycast.app UserDefaults, then relaunches it. Re-run after a rebuild. It refuses to steal cmd+space if Spotlight still owns that shortcut.

Shortcuts

Chord	Action
cmd+space	Palette
cmd+shift+V	Clipboard history
cmd+shift+N	Notes
cmd+shift+R	Rewrite selected text
cmd+shift+T	Summarize selected text
cmd+opt+A	Switch audio output (skips the full login zsh)
cmd+opt+T	Toggle Tailscale (connect or disconnect, then a notification)
meh+f	Sysmon overlay, centered (last window; first start creates btop / disk / vault)
cmd+opt+G	Overlay docked on the right (~1/4)
cmd+opt+V	Overlay docked on the left (~1/4)

Move Alter off cmd+shift+R (use cmd+shift+D) or rewrite loses the race on launch.

Audio

Custom Commands, not Quick Actions. The picker lists devices that are available right now.

Command	What it does
Switch Audio	Native list of live outputs plus paired Bluetooth audio (AirPods, Jabra, and the rest). Picking an offline headset connects it, then switches. A second cmd+opt+A focuses the open list instead of stacking another window.
Audio: Mac Speakers	Built-in speakers and mic
Audio: Disconnect	Connected Bluetooth device to drop

Palette search also finds audio, speakers, and disconnect.

The CLI is ~/.local/bin/audio-switch (stowed from dotfiles/bin). Commands live in scripts/tinycast/custom-commands.json and are merged by setup without deleting other Custom Commands you add in the UI.

audio-switch list
audio-switch status
audio-switch set air
audio-switch hide kuycon "microsoft teams" "jump desktop"
audio-switch hidden
audio-switch unhide kuycon

The picker hides display and virtual devices (Kuycon, Microsoft Teams, Jump Desktop) by default. hide / unhide edit ~/.config/audio-switch/hidden (substring match). Those devices stay installed; they are only omitted from the list.

Needs switchaudio-osx and blueutil from scripts/macos-deps.sh. Switching output does not disconnect Bluetooth; use Audio: Disconnect for that.

Tailscale

cmd+opt+T runs tailscale-toggle the same way Switch Audio runs: a Tinycast Custom Command, no login zsh. It disconnects when Tailscale is running and connects again with tailscale up, which keeps the saved profile. A second press while that is in flight is ignored. The menu bar is not opened.

tailscale-toggle
tailscale-toggle status

Needs the Tailscale app. Palette search finds tailscale.

System monitor

meh+f raises one kitty overlay attached to the sysmon tmux session, centered, and leaves whatever window you last used. Close it with cmd+w. cmd+opt+G docks the same overlay on the right at one quarter width. cmd+opt+V docks it on the left at that same width. The overlay floats above the app underneath, including Dia and Ghostty. cmd+shift+opt+v and cmd+shift+opt+g open a separate Kitty window running Herdr and tile it beside Dia, on the left or the right quarter. cmd+shift+opt+r and cmd+shift+opt+t do the same beside Aside. That window is not attached to tmux. Ctrl+Shift+H/L moves between Herdr and the app. The same chord focuses that sidebar when it is already in place. Close the Herdr window to dismiss it. meh+f stays the sysmon performance overlay. Those dock chords are a Tinycast Custom Command plus a Karabiner HID rule, not skhd: cmd+opt+F stays with Cursor Replace in Files. First start creates windows 1 and 3 (btop, vault) and lands on btop. The disk window (window 2, dua) opens only on demand, because it scans all of $HOME. The Herdr sidebar is a separate Kitty window, not a tmux window. Vault Neovim starts through a login zsh so AstroNvim gets the same PATH as Ghostty. Palette search still finds processes, disk, vault, dock, and dock left. The session loads ~/.tmux.conf.

sysmon
sysmon dock
sysmon dock-left
sysmon processes
sysmon disk
sysmon vault
sysmon stop

Needs btop, dua-cli, tmux, and kitty from scripts/macos-deps.sh.