Authenticate with the Shipables registry using GitHub OAuth.
shipables login & logout
Manage your authentication with the Shipables registry.
Login
shipables login
This authenticates you with the registry via GitHub OAuth. The flow:
- The CLI starts a temporary local HTTP server
- Opens your browser to the GitHub authorization page
- After you authorize, GitHub redirects back to the CLI
- The CLI receives an API token and stores it locally
- Your username is fetched and stored alongside the token
Your token is stored in ~/.shipables/config.json with read and publish scopes, valid for 365 days.
If the browser doesn't open
The CLI prints the login URL to the terminal. Copy and paste it into your browser manually.
Authentication timeout
The login flow times out after 2 minutes. If you see a timeout error, run shipables login again.
Non-interactive login (CI / AI agents)
For CI pipelines or AI coding agents, pass a token directly:
shipables login --token cbl_xxxxx
You can create API tokens from Settings > API Tokens on the web app.
Logout
shipables logout
Removes the stored token and username from ~/.shipables/config.json. This is a local operation — it doesn't revoke the token on the server.
To revoke tokens server-side, go to Settings > API Tokens on the web app.
Checking auth status
To see if you're currently logged in:
shipables config list
This shows your username and token status alongside other config values.