High-leverage commands

These are the commands most likely to change how you work day to day.

System health: ,doctor

• Source: home/exact_bin/executable_,doctor
• Checks: chezmoi state, Homebrew, shell, tmux+TPM, git+signing, SSH agent, pass/GPG, editors, AI tools, key CLIs, ~/bin wrapper integrity, cursor-cli bundled rg, and worktrees.
• AI effective state: ,doctor ai traces each generated AI config from source declaration and transforms through selected profile, owned target projection, runtime consumer, and an optional local liveness probe.

,doctor
,doctor --quiet
,doctor --verbose
,doctor ai
,doctor ai --json
,doctor ai --live --verbose

,doctor ai is static by default and never applies configs, refreshes tokens, or contacts remote services. --live runs each distinct local harness --version probe once, even when several artifacts share that consumer.

PR readiness: ,kbn-pr-audit

• Source: home/exact_bin/executable_,kbn-pr-audit
• Scope: read-only audit of an elastic/kibana PR before a reply/resolve/push cycle.
• Checks: local HEAD vs PR head, unresolved review threads split human vs bot, deletions disclosed in the body, expected body sections, label consistency, backport target consistency, and Test Plan validation commands.

,kbn-pr-audit
,kbn-pr-audit 271562

Worktrees: ,w

• Source: home/exact_bin/executable_,w
• Helpers: home/exact_lib/exact_,w/ and home/exact_lib/exact_shared/

,w add feat/my-change main
,w prs 12345
,w issue 12345
,w switch
,w doctor

For the full workflow, see Git worktrees.

GitHub lookup and bootstrap

Command	Purpose
,gh-prw	Resolve/open the current branch's PR; can print number or URL
,gh-issuew	Resolve/open the issue from branch suffix, worktree metadata, or PR body
,gh-worktree	Create or reuse local PR/issue worktrees from GitHub context
,gh-tfork	Fork/clone a repo and create a tmux session

Sources live under home/exact_bin/.

,gh-prw --url
,gh-issuew --number
,gh-tfork elastic/integrations

,gh-tfork clones to ~/work/<repo>/<default-branch> for elastic/* and ~/code/<repo>/<default-branch> otherwise. For elastic/kibana, it uses date-anchored shallow history (--shallow-since=2022-01-01 --no-tags).

Patch, file, and clipboard transfer: ,wh

• Source: home/exact_bin/executable_,wh (thin launcher) → home/exact_lib/exact_,wh/main.sh
• ,wh send writes the current staged diff to /tmp/staged.patch and sends it with Magic Wormhole.
• ,wh send <path> sends a single file or archives a directory first.
• ,wh send --clip sends the clipboard: text is sent as text, images are sent as PNG.
• cmd | ,wh send - sends piped stdin.
• ,wh recv receives and auto-detects: apply patch, load a clipboard envelope, extract archive, or save file/dir. Patches first use direct git apply, preserving the existing unstaged behavior when it succeeds. If direct application fails, ,wh attempts git apply --3way; Git stages a clean three-way result. A conflict leaves standard conflict markers and unmerged index entries for later resolution, and the command exits non-zero. A received clipboard envelope is loaded into the clipboard (text is also echoed to stdout, PNG restores the image); add --save to write the payload to -o/CWD instead.
• Fish and Zsh completions cover send, recv, --clip, path arguments, --save, and -o/--output.

,wh send                 # send staged diff
,wh send ./src           # send a directory
,wh send notes.md        # send a single file
,wh send --clip          # send the clipboard (text or image)
cmd | ,wh send -         # send piped stdin
,wh recv                 # receive (prompts for code), auto-handle
,wh recv -o ~/inbox      # save received file/dir into ~/inbox

Multi-PR patching: ,add-patch-to-prs

• Source: home/exact_bin/executable_,add-patch-to-prs
• Applies one patch file across selected PRs.
• Opens an interactive multi-select picker when PR numbers are omitted.

,add-patch-to-prs ./fix.patch 12345 12346
,add-patch-to-prs ./fix.patch --search "is:open author:@me"
,add-patch-to-prs ./fix.patch --message "Apply follow-up fix"

Telegram TUI launcher: ,tg

• Source: home/exact_bin/executable_,tg
• Prefers a locally built jar from ~/code/telegramtui/main/target/telegramtui-*.jar.
• Falls back to telegramtui on PATH.
• Optionally writes ~/.telegramtui/config.properties from pass entries telegram/apps/tuilegram/app_id and telegram/apps/tuilegram/api_hash.

,tg
,tg --sync
,tg --build
,tg --help

Package and icon reconverge helpers

Command	Purpose
,pull-rebase	Resolve branch upstream and run git pull --rebase behind a confirmation prompt
,install-yarn-pkgs	Reconcile global Yarn packages against ~/.default-yarn-pkgs
,apply-app-icons	Apply app icon mappings from home/app_icons/readonly_icon_mapping.yaml, refreshing Dock/Finder by signaling only the current user's own numeric PIDs (no killall/pkill)

tmux helpers

Command	Purpose
,tmux-run-all	Run one command across matching tmux sessions
,tmux-lowfi	Start/control lowfi in a dedicated tmux session

,tmux-run-all "work-*" "git status"
,tmux-run-all --all "work-*" "yarn run test -- --watch=false"
,tmux-lowfi p
,tmux-lowfi nt
,tmux-lowfi q