Logo
Vygrant
Overview

Vygrant

OAuth2 daemon + CLI that provides token retrieval and refresh for legacy applications.

1 min read (4 min read total)
5 pages
OAuth2 Go CLI Daemon

Overview

Vygrant runs a local daemon and exposes token operations through a CLI. It is designed for apps that need OAuth2 access tokens but cannot implement full OAuth2 browser flows.

What It Handles

  • OAuth2 callback handling on localhost (/auth)
  • Token retrieval and refresh
  • Per-account token operations (get, refresh, delete)
  • Optional token persistence using keyring/pass/file fallback

Runtime Model

  • Daemon process: vygrant server
  • Local command transport: Unix domain socket
  • CLI commands send requests to daemon (accounts, status, info, token *)

Typical Flow

  1. Configure one or more OAuth2 accounts in vygrant.toml.
  2. Start daemon.
  3. Run token command for a specific account.
  4. Complete provider auth in browser if needed.
  5. Consume access token from CLI output in your legacy tool.