🚨 This project is archived

Native voice/STT support has been officially added to Claude Code via the /voice command — use that instead. This repo is no longer maintained.

Claude STT

Speech-to-text input for Claude Code. Hold a hotkey, speak, and your words appear in the input field — all processed locally.

Install

Inside a Claude Code instance, run the following commands:

Step 1: Add the marketplace

/plugin marketplace add jarrodwatts/claude-stt

Step 2: Install the plugin

/plugin install claude-stt

Step 3: Run setup

/claude-stt:setup

Done! Press Ctrl+Shift+Space to start recording, press again to stop and transcribe.

Note: Setup installs dependencies (uv if available, otherwise a local .venv),
downloads the Moonshine model (~200MB), and checks microphone permissions.

What is Claude STT?

Claude STT gives you voice input directly into Claude Code. No typing required — just speak naturally.

How It Works

Press Ctrl+Shift+Space → start recording
        ↓
Audio captured from microphone
        ↓
Press Ctrl+Shift+Space → stop recording
        ↓
Moonshine STT processes locally (~400ms)
        ↓
Text inserted into Claude Code input

Key details:

• Audio is processed in memory and immediately discarded
• Uses Moonshine ONNX for fast local inference
• Keyboard injection or clipboard fallback
• Native system sounds for audio feedback

Configuration

Customize your settings anytime:

/claude-stt:config

Options

Settings stored in ~/.claude/plugins/claude-stt/config.toml.

Requirements

• Python 3.10-3.13
• ~200MB disk space for STT model
• Microphone access

Platform-Specific

Commands

You can also use the CLI directly:

claude-stt setup
claude-stt start --background

Troubleshooting

Logging

Set CLAUDE_STT_LOG_LEVEL=DEBUG to get verbose logs when starting the daemon.

Privacy

All processing is local:

• Audio captured from your microphone is processed entirely on-device
• Moonshine runs locally — no cloud API calls
• Audio is never sent anywhere, never stored (processed in memory, discarded)
• Transcribed text only goes to Claude Code input or clipboard

No telemetry or analytics.

Development

git clone https://github.com/jarrodwatts/claude-stt
cd claude-stt

# Install dependencies (uv preferred, falls back to local venv)
python scripts/setup.py --dev --skip-audio-test --skip-model-download --no-start

# Test locally without installing
claude --plugin-dir /path/to/claude-stt

See CONTRIBUTING.md for guidelines.

Release Checklist

• Bump versions in pyproject.toml, .claude-plugin/plugin.json, .claude-plugin/marketplace.json
• Update CHANGELOG.md
• Run tests: uv run python -m unittest discover -s tests
• Verify onboarding in Claude Code (/plugin install, /claude-stt:setup)

License

MIT — see LICENSE

Star History

{
  "name": "jarrodwatts-claude-stt",
  "owner": {
    "name": "Jarrod Watts",
    "url": "https://github.com/jarrodwatts"
  },
  "plugins": [
    {
      "name": "claude-stt",
      "source": "./",
      "description": "Speech-to-text input for Claude Code with live streaming dictation. Hold a hotkey, speak, and your words appear in the input field.",
      "version": "0.1.0",
      "author": {
        "name": "Jarrod Watts",
        "url": "https://github.com/jarrodwatts"
      },
      "homepage": "https://github.com/jarrodwatts/claude-stt",
      "repository": "https://github.com/jarrodwatts/claude-stt",
      "license": "MIT",
      "keywords": [
        "speech-to-text",
        "stt",
        "voice",
        "dictation",
        "moonshine",
        "audio",
        "accessibility"
      ]
    }
  ]
}