shipables login & logout

Manage your authentication with the Shipables registry.

Login

shipables login

This authenticates you with the registry via GitHub OAuth. The flow:

1. The CLI starts a temporary local HTTP server
2. Opens your browser to the GitHub authorization page
3. After you authorize, GitHub redirects back to the CLI
4. The CLI receives an API token and stores it locally
5. 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.