Name	Name	Last commit message	Last commit date
parent directory ..
claude-global	claude-global
codex-global	codex-global
cursor-global	cursor-global
README.md	README.md
aftertone-root.sh	aftertone-root.sh
aftertone_on	aftertone_on
bootstrap.ps1	bootstrap.ps1
bootstrap.sh	bootstrap.sh
install.ps1	install.ps1
install.sh	install.sh
publish_readme_demo_video.sh	publish_readme_demo_video.sh
repair-windows-hooks.ps1	repair-windows-hooks.ps1
uninstall.ps1	uninstall.ps1
uninstall.sh	uninstall.sh
verify_uninstall_windows.ps1	verify_uninstall_windows.ps1

`scripts/`

Script	Platform	Role
`install.sh`	Linux / macOS	One-line install (clone or update, bootstrap, global hooks). README
`install.ps1`	Windows	Same flow in PowerShell. README
`uninstall.sh`	Linux	Stop daemon, remove global Cursor hooks, optionally delete install tree. README
`uninstall.ps1`	Windows	Stop daemon, remove global Cursor hooks, optionally delete install tree. README
`bootstrap.sh`	Linux / macOS	`uv sync` in `py/`, download `Supertone/supertonic-3` into `assets/` when missing
`bootstrap.ps1`	Windows	Same as `bootstrap.sh` (no bash required)
`repair-windows-hooks.ps1`	Windows	Re-register global hooks, enable TTS, remove clashing project `hooks.json`
`aftertone-root.sh`	all (bash)	Resolve install path; copied to `~/.cursor/hooks/` by install
`aftertone_on`	Linux / macOS	Start Claude Code with the Aftertone plugin (`~/.local/bin/aftertone_on` after install)
`cursor-global/`	all	Templates for `install_global_hooks.py` (`.cmd` + `hooks.windows.json`)

Aftertone v2 CLI

From install root (~/aftertone or %USERPROFILE%\aftertone):

uv run --directory py python -m aftertone on|off|toggle|status|restart|repair|apply-defaults|doctor|speak "hello"

summary_mode = "tag_only" (default): only <spoken_summary> is spoken. Use auto for fallback extraction when the tag is missing.
Optional MCP template: cursor-global/mcp.aftertone.json — control only, not the speech trigger.

Hook replay: bash py/diagnose_speak_hooks.sh [hook.json]

Python 3.13 is pinned in py/.python-version (onnxruntime wheels; avoid system Python 3.14+ on Windows).

`install.sh`	`install.ps1`	Meaning
`--dir PATH`	`-InstallDir PATH`	Clone location (default `~/aftertone` or `%USERPROFILE%\aftertone`)
`--global`	(default)	Register user hooks in `.cursor/`
`--no-global`	`-NoGlobal`	Skip `.cursor/hooks.json` registration
`--into PATH`	—	Legacy (bash only): copy hooks + `py/` into another repo
`--branch NAME`	`-Branch NAME`	Git branch (default `main`)
`--skip-assets`	`-SkipAssets`	Skip model download
`--start-daemon`	(default on Windows)	Run `tts_daemon_ctl.py start` after bootstrap
`--install-uv`	(default on Windows)	Install uv if missing
—	`-NoStartDaemon`	Skip daemon start (Windows only)
—	`-NoEnableTts`	Leave `enabled=false` in TOML (Windows only)

Env: AFTERTONE_INSTALL_DIR, AFTERTONE_REPO_URL, AFTERTONE_BRANCH.

bootstrap.sh / bootstrap.ps1 env: SKIP_ASSETS=1, SKIP_WEB=1, FORCE_ASSETS=1.

`uninstall.sh`	`uninstall.ps1`	Meaning
`--dir PATH`	`-InstallDir PATH`	Install root (default: marker file, then `~/aftertone` or `%USERPROFILE%\aftertone`)
`--keep-dir`	`-KeepDir`	Remove hooks only; keep clone and `assets/`
`--no-global`	`-NoGlobal`	Skip user `.cursor` cleanup (daemon stop + delete install dir only)
`--yes`	`-Yes`	Do not prompt before deleting install directory
`--dry-run`	`-DryRun`	Print planned actions

Env: AFTERTONE_INSTALL_DIR, AFTERTONE_UNINSTALL_RAW_BASE (override raw GitHub URL prefix for hook scripts when the install tree is already gone).

User hooks on Windows use .\hooks\aftertone-speak_summary.cmd, which calls Git Bash and the real speak_summary.sh under your install dir.