Skip to content

mguttmann/typewhisper-plugins

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Claude (OAuth Pro/Max) — TypeWhisper Plugin

Use your Anthropic Claude Pro/Max subscription as an LLM provider in TypeWhisper for text post-processing of dictated text — no API key, no per-token billing.

This is a fork of TypeWhisper/typewhisper-plugins that adds the claude-oauth plugin. It is not part of the official TypeWhisper catalog (see Heads-up below for why).

Install

Option A — Download the prebuilt bundle (no Xcode needed)

  1. Download ClaudeOAuthPlugin-*-macos-universal.bundle.zip from the latest release.
  2. Unzip it (double-click) → you get ClaudeOAuthPlugin.bundle.
  3. Clear the download-quarantine flag and move it into TypeWhisper's plugin folder:
    xattr -dr com.apple.quarantine ~/Downloads/ClaudeOAuthPlugin.bundle
    mv ~/Downloads/ClaudeOAuthPlugin.bundle \
       ~/Library/Application\ Support/TypeWhisper/Plugins/
  4. Quit and restart TypeWhisper.

Option B — Build from source (needs Xcode command line tools)

git clone https://github.com/mguttmann/typewhisper-plugins.git
cd typewhisper-plugins/plugins/claude-oauth
./install.sh

Then quit and restart TypeWhisper.

After restarting, activate the plugin under Settings → Plugins → Claude (OAuth Pro/Max).

Full usage, setup steps, model list, and refresh details: see plugins/claude-oauth/README.md.

Requirements

  • macOS 14.0+ (Apple Silicon or Intel — the prebuilt bundle is universal)
  • TypeWhisper 1.4.0+
  • An active Claude Pro or Claude Max subscription
  • For Option B only: Xcode command line tools (xcode-select --install)

macOS only. TypeWhisper for Windows uses a completely separate C#/.NET plugin system, so this Swift plugin cannot run there — not even by rebuilding. A Windows version would be a full rewrite in C#. (Windows already has an official API-key-based Claude plugin; a Pro/Max-OAuth equivalent would have to be written from scratch.) See the plugin README for details.

Heads-up

This plugin uses the same OAuth client identifier that Claude Code uses internally and identifies API requests as Claude Code so that Pro/Max subscriptions accept them. That is an unofficial use of the subscription under Anthropic's Terms of Service, which is why it is not in the official TypeWhisper catalog. It may stop working if Anthropic changes their OAuth client policy. Tokens are stored only in the macOS Keychain; no telemetry is sent anywhere except api.anthropic.com and platform.claude.com. Use at your own risk.

About

Community plugins for TypeWhisper

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Swift 69.8%
  • Shell 14.8%
  • JavaScript 11.9%
  • Python 3.5%