---
name: wispr-upgrade-migration
description: 'Wispr Flow upgrade migration for voice-to-text API integration.

  Use when integrating Wispr Flow dictation, WebSocket streaming,

  or building voice-powered applications.

  Trigger: "wispr upgrade migration".

  '
allowed-tools: Read, Write, Edit, Bash(npm:*), Grep
version: 1.0.0
license: MIT
author: Jeremy Longshore <jeremy@intentsolutions.io>
tags:
- saas
- voice
- dictation
- wispr
compatibility: Designed for Claude Code
---
# Wispr Flow Upgrade Migration

## Overview

Guidance for upgrade migration with Wispr Flow voice-to-text API.

## Instructions

### Key Wispr Flow Concepts

- **WebSocket API**: `wss://api.wisprflow.ai/api/v1/ws` (recommended, low latency)
- **REST API**: `POST /api/v1/transcribe` (simpler, higher latency)
- **Auth**: API key (backend) or access token (client-side)
- **Audio format**: 16kHz mono PCM preferred
- **Context awareness**: Understands code, CLI commands, dev jargon
- **Platforms**: Mac, Windows, iOS, browser API

## Error Handling

| Error | Cause | Solution |
|-------|-------|----------|
| `401 Unauthorized` | Invalid key | Check at wisprflow.ai/developers |
| WebSocket closed | Network issue | Reconnect with backoff |
| Poor accuracy | Wrong context | Set context to 'programming' for code |

## Resources

- [Wispr Flow Developers](https://wisprflow.ai/developers)
- [API Docs](https://api-docs.wisprflow.ai/introduction)
- [WebSocket Quickstart](https://api-docs.wisprflow.ai/websocket_quickstart)

## Next Steps

See related Wispr Flow skills for more patterns.
