Skip to main content

​
Usage

toolshed connect <provider>
ArgumentRequiredDescription
providerYesOne of: github, google, slack, linear

​
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

$ toolshed connect github
Connecting github...
Opening browser to authorize github...
Connected github successfully!

​
Checking connections

Use toolshed status to see which providers are connected: 
$ toolshed status
Server:  http://localhost:3001
User:    user_f7c469e8
Providers: github, google

​
Provider details

ProviderPKCEScopes
GitHubNorepo, read:user
GoogleYes (S256)gmail.modify, calendar, drive.readonly
SlackNochannels:read, chat:write, groups:read
LinearYes (S256)read, write
See OAuth Setup for server-side configuration requirements.