Contributor guide: workflows (Codex + multi-tool setups)

[omarelkhal]

Goal

Collect real-world setup notes now that Cursor and Claude Code adapters are shipped. This issue is not for building the Claude adapter (done — see #10).

Shipped today

Tool	Install	Control	Docs
Cursor	Global hooks via install.sh	/aftertone-on per chat, slash commands	hooks README
Claude Code	Same global install	/aftertone_on per chat	docs/adapters/claude.md
Codex	—	—	Not shipped — #11

Default install: curl -fsSL .../install.sh | bash -s -- --install-uv --start-daemon → ~/aftertone.

What we want from you

Short write-up (comment or PR) — no secrets:

• Which tools you use together (e.g. Cursor + Claude, Cursor only, WSL, etc.)
• Install root and how you start/check the daemon
• Session allowlist: /aftertone-on per chat — what confused you?
• <spoken_summary> tag quality tips for your workflow
• What worked / what hurt

Where to land it

• PR: subsection in CONTRIBUTING.md or docs/ (e.g. docs/community-workflows.md)
• Or paste a draft in a comment on this issue

Related

• Codex adapter research: #11
• Starter issue templates: .github/STARTER_ISSUES.md

[omarelkhal]

Update (May 2026): Claude Code adapter is shipped on `main` — global Stop hook, `/aftertone_*` commands, docs/adapters/claude.md. Tracked in closed #10.

This issue stays open for community workflow write-ups (especially Codex) and maintainer field notes — paste your Cursor + Claude setup here if you dogfood both.