> Documentation index: https://docs.kiste.run/llms.txt, a list of every page in this documentation.

# Overview

> Every command of the kiste CLI, its arguments, options, aliases and global options.

The Kiste CLI is installed as `kiste` and, for short, `kst`; both names are the same program. This reference is generated from the CLI's own command tree, so it lists exactly what the current release accepts. `kiste --help` shows the overview and `kiste help COMMAND` the same details as these pages.

## Commands

| Command | Aliases | What it does |
| --- | --- | --- |
| [login](https://docs.kiste.run/cli/login.md) |  | Log in through a short-lived browser OAuth flow |
| [logout](https://docs.kiste.run/cli/logout.md) |  | Revoke the access token, then remove it locally |
| [whoami](https://docs.kiste.run/cli/whoami.md) |  | Show the currently authenticated user |
| [account](https://docs.kiste.run/cli/account.md) |  | Download your account's data, or delete the account |
| [new](https://docs.kiste.run/cli/new.md) | `start`, `run` | Start a new Kiste, then connect over SSH or open its desktop |
| [credentials](https://docs.kiste.run/cli/credentials.md) | `creds` | Choose which of your logins new Kisten may carry, and carry them |
| [ssh](https://docs.kiste.run/cli/ssh.md) | `shell`, `terminal` | Connect to a running Kiste |
| [ssh-config](https://docs.kiste.run/cli/ssh-config.md) |  | Print an OpenSSH configuration for your Kisten |
| [exec](https://docs.kiste.run/cli/exec.md) |  | Execute a command and return its exact stdout, stderr and exit code |
| [prompt](https://docs.kiste.run/cli/prompt.md) |  | Run a pinned coding agent non-interactively inside a Kiste |
| [cancel](https://docs.kiste.run/cli/cancel.md) |  | Cancel a native command by its client-supplied UUID |
| [interrupt](https://docs.kiste.run/cli/interrupt.md) |  | Cooperatively interrupt a command by its global command ID |
| [command](https://docs.kiste.run/cli/command.md) |  | Show the durable final or in-flight state of a native command |
| [commands](https://docs.kiste.run/cli/commands.md) |  | List durable native commands for one Kiste |
| [desktop](https://docs.kiste.run/cli/desktop.md) |  | Open a running desktop Kiste in the browser |
| [list](https://docs.kiste.run/cli/list.md) | `ls` | List your Kisten |
| [status](https://docs.kiste.run/cli/status.md) | `inspect`, `info` | Show one Kiste in detail |
| [current](https://docs.kiste.run/cli/current.md) | `self` | Print or change the locally selected Kiste |
| [watch](https://docs.kiste.run/cli/watch.md) |  | Poll one Kiste and emit deterministic status events until interrupted |
| [events](https://docs.kiste.run/cli/events.md) |  | Read the durable event stream of your account |
| [stop](https://docs.kiste.run/cli/stop.md) |  | Shut a Kiste down cleanly. The next start is a fresh boot |
| [restart](https://docs.kiste.run/cli/restart.md) |  | Reboot a Kiste and optionally reconnect |
| [rename](https://docs.kiste.run/cli/rename.md) |  | Rename a Kiste. The name inside the Kiste follows on its next update or cold boot |
| [update](https://docs.kiste.run/cli/update.md) | `upgrade` | Cold-boot a Kiste onto the newest image (the session ends) |
| [resume](https://docs.kiste.run/cli/resume.md) |  | Resume a stopped Kiste |
| [extend](https://docs.kiste.run/cli/extend.md) |  | Push a Kiste's automatic stop further out |
| [fork](https://docs.kiste.run/cli/fork.md) |  | Clone a running Kiste into an independent Kiste |
| [scp](https://docs.kiste.run/cli/scp.md) |  | Copy files over the SSH transport |
| [forward](https://docs.kiste.run/cli/forward.md) |  | Forward a local TCP port to the Kiste until interrupted |
| [delete](https://docs.kiste.run/cli/delete.md) | `rm` | Permanently delete a Kiste and its disk |
| [logs](https://docs.kiste.run/cli/logs.md) |  | Print the console log of a Kiste |
| [image](https://docs.kiste.run/cli/image.md) | `images` | Build, inspect and remove machine images |
| [snapshot](https://docs.kiste.run/cli/snapshot.md) | `snapshots` | Capture, restore, inspect and delete durable Kiste snapshots |
| [environment](https://docs.kiste.run/cli/environment.md) |  | Manage immutable, versioned launch environments |
| [stream](https://docs.kiste.run/cli/stream.md) |  | Kiste Stream: publish a port of a Kiste at its own address under kiste.stream |
| [auth](https://docs.kiste.run/cli/auth.md) |  | Authentication commands grouped for automation and discoverability |
| [devices](https://docs.kiste.run/cli/devices.md) | `device` | List the computers whose SSH keys open your Kisten, or remove one |
| [config](https://docs.kiste.run/cli/config.md) |  | Inspect or change non-secret local CLI configuration |
| [completions](https://docs.kiste.run/cli/completions.md) |  | Generate a shell completion script on stdout |
| [self-update](https://docs.kiste.run/cli/self-update.md) | `self-upgrade` | Replace this executable with the latest checksum-verified release build |
| [limits](https://docs.kiste.run/cli/limits.md) |  | Show account quotas and usage |
| [doctor](https://docs.kiste.run/cli/doctor.md) |  | Check whether kiste.run is healthy and this CLI is signed in |

## Global options

These options work with every command, before or after it. Each one can also be set through its environment variable.

| Option | Description |
| --- | --- |
| `--output OUTPUT` | Output contract. JSON modes never open a browser, prompt, or attach SSH. Values: `human` (Compact output intended for a terminal), `json` (One stable JSON success or error envelope), `ndjson` (One JSON event per line; collections are streamed item by item). Default: `human`. Environment: `KISTE_OUTPUT`. |
| `--json`, `--machine` | Shorthand for `--output json`. |
| `--no-input` | Never prompt, open a browser, or implicitly attach to a Kiste. Environment: `KISTE_NO_INPUT`. |
| `--timeout SECONDS` | Maximum end-to-end API request deadline, and the deadline of `exec` commands: seconds, or 10m, 2h. Earlier server errors return immediately. Default: `960`. Environment: `KISTE_TIMEOUT`. |
| `--verbose`, `-v` | Print each step on stderr as it happens, with how long it took. Environment: `KISTE_VERBOSE`. |
| `--request-id REQUEST_ID` | Correlation ID sent with every request. Environment: `KISTE_REQUEST_ID`. |

`-h`, `--help` prints help for any command and `-V`, `--version` prints the version.

## Related topics

- [Output modes and exit codes](https://docs.kiste.run/cli/output.md)
- [Configuration and environment](https://docs.kiste.run/cli/configuration.md)
- [kiste login](https://docs.kiste.run/cli/login.md)
- [kiste logout](https://docs.kiste.run/cli/logout.md)
- [kiste whoami](https://docs.kiste.run/cli/whoami.md)
- [kiste account](https://docs.kiste.run/cli/account.md)
- [kiste new](https://docs.kiste.run/cli/new.md)
- [kiste credentials](https://docs.kiste.run/cli/credentials.md)
- [kiste ssh](https://docs.kiste.run/cli/ssh.md)
- [kiste ssh-config](https://docs.kiste.run/cli/ssh-config.md)
- [kiste exec](https://docs.kiste.run/cli/exec.md)
- [kiste prompt](https://docs.kiste.run/cli/prompt.md)
- [kiste cancel](https://docs.kiste.run/cli/cancel.md)
- [kiste interrupt](https://docs.kiste.run/cli/interrupt.md)
- [kiste command](https://docs.kiste.run/cli/command.md)
- [kiste commands](https://docs.kiste.run/cli/commands.md)
- [kiste desktop](https://docs.kiste.run/cli/desktop.md)
- [kiste list](https://docs.kiste.run/cli/list.md)
- [kiste status](https://docs.kiste.run/cli/status.md)
- [kiste current](https://docs.kiste.run/cli/current.md)
- [kiste watch](https://docs.kiste.run/cli/watch.md)
- [kiste events](https://docs.kiste.run/cli/events.md)
- [kiste stop](https://docs.kiste.run/cli/stop.md)
- [kiste restart](https://docs.kiste.run/cli/restart.md)
- [kiste rename](https://docs.kiste.run/cli/rename.md)
- [kiste update](https://docs.kiste.run/cli/update.md)
- [kiste resume](https://docs.kiste.run/cli/resume.md)
- [kiste extend](https://docs.kiste.run/cli/extend.md)
- [kiste fork](https://docs.kiste.run/cli/fork.md)
- [kiste scp](https://docs.kiste.run/cli/scp.md)
- [kiste forward](https://docs.kiste.run/cli/forward.md)
- [kiste delete](https://docs.kiste.run/cli/delete.md)
- [kiste logs](https://docs.kiste.run/cli/logs.md)
- [kiste image](https://docs.kiste.run/cli/image.md)
- [kiste snapshot](https://docs.kiste.run/cli/snapshot.md)
- [kiste environment](https://docs.kiste.run/cli/environment.md)
- [kiste stream](https://docs.kiste.run/cli/stream.md)
- [kiste auth](https://docs.kiste.run/cli/auth.md)
- [kiste devices](https://docs.kiste.run/cli/devices.md)
- [kiste config](https://docs.kiste.run/cli/config.md)
- [kiste completions](https://docs.kiste.run/cli/completions.md)
- [kiste self-update](https://docs.kiste.run/cli/self-update.md)
- [kiste limits](https://docs.kiste.run/cli/limits.md)
- [kiste doctor](https://docs.kiste.run/cli/doctor.md)
- Previous: [Delete your account](https://docs.kiste.run/account/delete-account.md)
- Next: [Output modes and exit codes](https://docs.kiste.run/cli/output.md)