auth

Manage CLI authentication. Log in interactively, switch between saved contexts, and inspect the current token.

Commands

Command	Description
`devhelm auth login`	Authenticate and save credentials
`devhelm auth logout`	Remove the active context
`devhelm auth me`	Show API key identity, organization, plan, and rate limits
`devhelm auth token`	Display the current API token
`devhelm auth context`	Show the active context
`devhelm auth context create <name>`	Create a named context
`devhelm auth context list`	List all contexts
`devhelm auth context use <name>`	Switch to a context
`devhelm auth context delete <name>`	Delete a context

Authenticate interactively and save credentials to ~/.devhelm/contexts.json. The token is validated against the API before saving — an invalid token exits with code 11 and saves nothing.

devhelm auth login

Skip the interactive prompt by passing the token directly:

devhelm auth login --token dh_live_xxxxxxxx --name production

Flag	Type	Default	Description
`--token`	string	—	API token (skips interactive prompt)
`--name`	string	`default`	Context name to save under

auth logout

Remove the active context from ~/.devhelm/contexts.json. If other contexts remain, the first one becomes active.

devhelm auth logout

auth me

Show the API key identity, organization, plan tier, rate limits, and usage counters for the resolved token.

devhelm auth me

devhelm auth me -o json

auth token

Display the resolved API token. Useful for piping into other tools:

devhelm auth token

export TOKEN=$(devhelm auth token)
curl -H "Authorization: Bearer $TOKEN" https://api.devhelm.io/api/v1/monitors

auth context

Show active context

devhelm auth context

Create a context

devhelm auth context create staging \
  --token dh_live_xxxxxxxx \
  --api-url https://api.devhelm.io

Flag	Type	Default	Description
`--token`	string	—	API token (required)
`--api-url`	string	`https://api.devhelm.io`	API base URL for this context
`--set-current`	boolean	`true`	Switch to this context immediately (always on — there is currently no `--no-set-current` variant; use `auth context use` to switch back)

List contexts

devhelm auth context list

The active context is marked with *.

Switch context

devhelm auth context use production

Delete a context

devhelm auth context delete staging

Getting Started

Commands

Commands

auth logout

auth me

auth token

auth context

Show active context

Create a context

List contexts

Switch context

Delete a context

Next steps

CLI authentication guide

API keys

​Commands

​auth login

​auth logout

​auth me

​auth token

​auth context

​Show active context

​Create a context

​List contexts

​Switch context

​Delete a context

​Next steps

CLI authentication guide

API keys

Commands

auth login

auth logout

auth me

auth token

auth context

Show active context

Create a context

List contexts

Switch context

Delete a context

Next steps