CLI reference
Authentication commands grouped for automation and discoverability.
kiste auth login
Log in through a short-lived browser OAuth flow.
| Option | Description |
|---|---|
--no-open | Print the authorization URL instead of opening it automatically. |
--with-token | Read an API token from standard input instead of using the browser (headless computers and CI): kiste login --with-token < token.txt. |
kiste auth logout
Revoke the access token, then remove it locally.
| Option | Description |
|---|---|
--local | Remove only the local token when kiste.run cannot be reached. |
kiste auth whoami
Show the currently authenticated user.
kiste auth token
Manage scoped, expiring API tokens for agents and CI.
kiste auth token create
Create a token. Its plaintext is returned exactly once.
| Argument | Description |
|---|---|
LABEL | Human-readable label used to identify and revoke the token. |
| Option | Description |
|---|---|
--expires-in EXPIRES_IN | Token lifetime in seconds. Default: 2592000. |
kiste auth token list
List token metadata; plaintext tokens are never returned.
Aliases: ls.
kiste auth token revoke
Revoke a token by ID.
| Argument | Description |
|---|---|
ID | Token UUID shown by kiste auth token list. |
Global options such as --json work with every command; see the CLI overview.