Manual OAuth Code Catcher

About

Manual OAuth Code Catcher is a developer tool designed for out-of-band OAuth 2.0 authorization code flows — situations where an OAuth client (CLI tool, backend service, IoT device, etc.) does not have a web browser available to complete the standard authorization code exchange.                         
                                                            
How it works:

During a typical 3-legged OAuth flow, the authorization server redirects the user's browser to a redirect URI with an authorization code in the URL parameters. When the client has no browser, this redirect goes nowhere -- making it impossible to capture the code automatically.

Manual OAuth Code Catcher solves this by intercepting that redirect on localhost or 127.0.0.1 at your configured port, extracting the authorization code, and displaying it to you instantly. You can then copy the code and pass it back to your client, which exchanges it for an access token.

Use case:
  1. Your headless client initiates an OAuth flow and opens the authorization URL
  2. You open that URL in any browser (even on a different device)
  3. You authenticate and authorize with the identity provider
  4. The browser redirects to localhost — Manual OAuth Code Catcher captures the code
  5. Copy the code and hand it off to your client