Good first issue: smoke-test spoken TTS after install

[omarelkhal]

Goal

Help verify the spoken TTS pipeline on a fresh install (Linux / macOS / Windows). Good for first-time contributors reporting OS-specific friction.

Recommended path (2026 — global install)

One-liner (registers Cursor + Claude hooks, downloads models, starts daemon):

curl -fsSL https://raw.githubusercontent.com/omarelkhal/aftertone/main/scripts/install.sh | bash -s -- --install-uv --start-daemon

Default install root: ~/aftertone (marker: ~/.cursor/hooks/aftertone-install-dir).

Then:

1. Cursor: Settings → Hooks enabled · trust your workspace · /aftertone-on in the chat you are testing · agent reply with <spoken_summary>…</spoken_summary> (repo default: tag only — no tag = silence).
2. Claude Code (optional): claude → /aftertone_on in that chat — see docs/adapters/claude.md.
3. Pipeline smoke (no Cursor needed):

   INSTALL="$(cat ~/.cursor/hooks/aftertone-install-dir)"
   cd "$INSTALL/py" && uv run python tts_daemon_ctl.py status --repo-root ..
   SPEAK_SUMMARY_IGNORE_QUIET=1 bash "$INSTALL/py/test_speak_summary_pipeline.sh"

4. Doctor: uv run --directory "$INSTALL/py" python -m aftertone doctor

Legacy path (clone + bootstrap only)

Still valid for hacking on the repo itself:

git clone https://github.com/omarelkhal/aftertone.git && cd aftertone
bash scripts/bootstrap.sh
cd py && uv run python tts_daemon_ctl.py start --repo-root ..

For hooks in this clone only, use install.sh --no-global --into . or open the repo root in Cursor with project hooks.

PR welcome

• Clearer errors or docs for your OS (especially Windows / WSL audio)
• Small fixes to py/test_speak_summary_pipeline.sh or install scripts
• Note: 45+ pytest tests already cover speak_summary_prepare.py — this issue is end-to-end audio + hooks, not unit tests

When reporting, include: OS, Python/uv version, Cursor vs Claude, and whether you used global install or clone-only.

[omarelkhal]

Issue body refreshed for global install (install.sh), per-chat /aftertone-on, Claude optional path, and aftertone doctor. Still a good first issue for end-to-end smoke reports.