Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cirron.com/llms.txt

Use this file to discover all available pages before exploring further.

​
cirron auth

Authenticate with Cirron, manage your API token, and check authentication status.

​
Subcommands

  • cirron auth login — Log in with your Cirron API token
  • cirron auth logout — Log out and remove your token
  • cirron auth status — Check current authentication status
  • cirron auth refresh — Refresh your authentication token

​
Usage

cirron auth <subcommand> [options]

​
Subcommand Details

​
Login

Authenticate with your Cirron API token. You can provide the token as an option or interactively. 
cirron auth login [--token <token>] [--url <api-url>]
OptionDescriptionDefault
--tokenAPI token for authenticationPrompted
--url, -uAPI URLhttps://app.cirron.com

​
Example

# Interactive login
cirron auth login

# Login with token
cirron auth login --token sk-1234...

# Login with custom API URL
cirron auth login --url https://app.cirron.com

​
Logout

Log out and remove your API token from the local configuration. 
cirron auth logout

​
Example

cirron auth logout

​
Status

Check your current authentication status, user info, and token expiry. 
cirron auth status

​
Example

cirron auth status

​
Refresh

Refresh your authentication token without re-entering credentials. 
cirron auth refresh

​
Example

cirron auth refresh

​
Authentication Flow

  1. Login: Stores your API token in the local config after verifying with the Cirron API.
  2. Logout: Removes the token from your config.
  3. Status: Checks token validity, user info, and expiry.

​
Troubleshooting

  • Invalid Token: If your token is invalid or expired, you’ll be prompted to re-authenticate.
  • Not Authenticated: If not logged in, most project commands will fail until you authenticate.
  • Token Expiry: Status will warn you if your token is expiring soon.

​
Best Practices

  • Use cirron auth login before running project commands.
  • Use cirron auth logout if you need to switch accounts or remove credentials.
  • Check cirron auth status if you encounter authentication errors.