Skip to main content

Usage

How it works

  1. The CLI starts a temporary HTTP server on a random local port
  2. Opens your browser to the Toolshed server’s /api/auth/cli-login endpoint, passing the local callback URL
  3. The server generates a user ID and session token, then redirects back to the CLI’s callback
  4. The CLI saves the credentials to ~/.toolshed/config.json and exits

Example

Config file

After login, credentials are stored in ~/.toolshed/config.json:
This file is used by toolshed serve, toolshed connect, and toolshed status.

If already logged in

Running login again will print the current session and exit. To log in to a different server, delete ~/.toolshed/config.json first.