CLAUDE.md · git:20260926.96b1b5a · 2026-09-26 · sha256 c0354c34c13d320e

CLAUDE.md git:20260926.96b1b5aA

Immutable. This exact content never changes and is served at /api/v1/blob/c0354c34c13d320e.

# claudeTalk: notes for Claude Code

Voice for Claude Code on Windows: talk mode (Claude speaks), local dictation, a
wake phrase, and a glass overlay. Since v0.7.0 it is two native Rust programs;
there is no Python or PowerShell left.

## Layout
- `bin\claudetalk.exe`: hooks (`hook prompt|stop|session-start`), the `say` MCP
  server (`mcp`), `/talk` (`toggle`), the speech player (`speaker`) and
  `cleanup`.
- `bin\claudetalk-dictation.exe`: the dictation daemon (tray, overlay, Whisper,
  wake phrase).
- `native\`: the Rust sources.
  - `native\SPEC.md` is the behavior contract. Check it before changing
    behavior, and list intentional changes in its last section.

## Build
```
native\build.cmd . cargo test --workspace
native\build.cmd . cargo build --release --workspace
```
- `build.cmd` sets up MSVC + Ninja + LLVM + the Vulkan SDK and writes to
  `C:\ctb`. MSBuild fails on long paths in whisper.cpp's shader build.
- Copy `C:\ctb\release\claudetalk*.exe` into `bin\`.
- `claudetalk-dictation.exe --render-test DIR 1.5` draws the pill and the
  panels to PNGs. The real windows are excluded from screen capture.

## Deploying to the installed plugin
Claude Code runs the plugin from `~\.claude\plugins\cache\claudeTalk\claudeTalk\<version>\`,
not from this repo. To try a change:
1. `git archive HEAD -- . ':!native'` into that folder.
2. If an exe there is in use (MCP servers, the speaker), move it to `%TEMP%` first.
3. Restart the daemon.

## Old versions leave files behind: clean them up
Up to v0.5 claudeTalk installed a Python environment (~3 GB). Claude Code's
cache can hold a copy of the plugin, with that environment, for every older
version; on the author's machine that was 37 GB.

If you find any of these, the user doesn't need them any more:
- `voice-input\` (in the repo or in a cached copy of the plugin);
- `%LOCALAPPDATA%\claudeTalk\venv`, and `%APPDATA%\claudeTalk\venv-path.txt`;
- `scripts\setup-voice.ps1`, `dictation.vbs` or any `scripts\*.ps1` other than
  `install-app.ps1`;
- the `faster-whisper-large-v3-turbo` model in `~\.cache\huggingface\hub`;
- `~\.claude\plugins\cache\claudeTalk\claudeTalk\<old versions>`;
- Start Menu or desktop shortcuts that run `wscript ... dictation.vbs`.

To clean up, run `bin\claudetalk.exe cleanup` to list what it would remove,
then `bin\claudetalk.exe cleanup --yes` once the user agrees. The
`SessionStart` hook already tells Claude when leftovers exist.

Do not remove ffmpeg or edge-tts on your own: claudeTalk no longer uses them,
but other tools may (the `audio-to-text` skill needs ffmpeg). Ask first.

## Conventions
- Commit each finished change. Don't push without being asked, and add no
  attribution lines.
- Versions: patch for small changes, minor for bigger ones. 1.0 only when the
  user says so.
- For every feature, update the README's feature table, the description in
  `.claude-plugin/plugin.json` and `marketplace.json`, and the GitHub repo
  description.