# ZoneGaze Whispr Plugin

## Role

First-party Matrix plugin for local-first dictation and transcription workflows.

## Source Boundaries

- Plugin package: `plugins/whispr/`
- Matrix adapter: `plugins/whispr/src/MatrixWhisprPluginPanel.tsx`

## Current Capability Signals

- Capability registry: `dictation`
- Runtime/package status: `ready`

## Major Features

- Dictation into Matrix surfaces
- Transcript history and saved recordings
- Personal dictionary and provider cleanup paths
- Upload-audio transcription surface
- Embedded Home/Dictionary/History/Extensions/Quick notes/Settings sections

## Current Matrix Coordination

- `Chat`: dictate prompts and replies directly into the chat composer.
- `Joplin`: quick-note handoff is implemented now, so captured dictation can become durable notes.
- `Flow`: use Whispr for long task notes, prompts, and review text inside the project workflow.
- `Code`: use Whispr when commit notes, searches, prompts, or code comments are faster to speak
  than type.
- `Open Design` and `Research`: broader voice coverage is planned, but the universal “voice input
  everywhere” layer is not finished yet.

## Related Docs

- [Plugin README](../../plugins/whispr/README.md)
- [Matrix plugin architecture](../architecture/matrix-plugin-architecture.md)
- [Matrix plugin coordination](plugin-coordination.md)
