opencode-sttOpenCode plugin for speech-to-text via Handy API
2
9
3 in 7 days
20.4
Multi-signal model
5 months ago
2026-02-22
Install and configure
opencode.jsonWrites to this project's opencode.json — applies to this repository only.
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["opencode-stt@0.1.0"]
}Writes to ~/.config/opencode/opencode.json — applies to every project.
~/.config/opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["opencode-stt@0.1.0"]
}If you want to modify the plugin locally, install it into the project and reference the local path.
shell
pnpm add -D opencode-sttopencode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.
OpenCode STT Plugin
Adds a /dictate command to OpenCode that records your voice and transcribes it using Handy. Run the command once to start recording, run it again to stop and get the transcription appended to your prompt.
Requirements
You need a build of Handy with the HTTP API enabled. The standard release doesn't have this yet, so grab it from this fork:
https://github.com/belohnung/Handy/tree/feat/http-api
Handy needs to be running locally on port 9876 before you use this plugin.
Usage
/dictate
First run starts recording. Second run stops, waits for transcription, and adds the result to your prompt.
Configuration
The plugin assumes Handy is running at http://localhost:9876. If you need a different setup, edit the HANDY_PORT constant in the source and rebuild.
Installation
Add to your OpenCode config file (e.g., ~/.config/opencode/config.json):
{
"plugins": ["opencode-stt@latest"]
}
Or install manually to your plugins directory.