CLI authentication

For the default local CLI flow, use browser login. The CLI opens the device approval page at www.sume.com/cli/login (with a user_code). Then the CLI waits for approval and stores a CLI-scoped API key in the local config.

As an alternative, you can create a key manually in the API Keys dashboard.

For a remote or headless terminal, use this command. It prints the approval URL and does not open a browser:

The CLI still supports manual API-key setup and environment variables for CI, server automation, and advanced local workflows:

x-api-key is the current CLI default. The CLI also supports SUME_API_AUTH_MODE=bearer for clients that select Authorization: Bearer.

By default, the CLI stores the local config in ~/.sume-com/config.json.