Skip to main content

Usage

Prerequisites

You must be logged in first. Run toolshed login if you haven’t already.

How it works

  1. The CLI reads your config from ~/.toolshed/config.json to get your user ID and server URL
  2. Starts a temporary local HTTP server on a random port
  3. Opens your browser to the server’s OAuth login endpoint for the chosen provider
  4. The server runs the standard OAuth2 flow (with PKCE where supported)
  5. After you authorize in the provider’s UI, the server stores encrypted tokens and redirects back to the CLI
  6. The CLI confirms the connection and exits

Example

Checking connections

Use toolshed status to see which providers are connected:

Provider details

See OAuth Setup for server-side configuration requirements.