---
title: Cheat sheet
sidebar_label: Cheat sheet
description: "The twenty clika-cli commands worth memorising, in one table."
---

Twenty commands cover most of what anyone does with `clika-cli`. Every one of them is documented in full on the page linked in the last column.

| # | Command | What it does |
| --- | --- | --- |
| 1 | `clika-cli --base-url https://platform.clika.io login --api-key` | Log in once and save the deployment and credential to a profile. The bare `--api-key` prompts, so the secret never reaches your shell history. [More](authentication.md#login) |
| 2 | `clika-cli whoami` | Show the platform, the key prefix, the principal and the capability count of the current credential (`auth me` takes a user session, which the CLI does not hold). [More](authentication.md#related-commands) |
| 3 | `clika-cli --profile onprem devices list` | Run any command against a second deployment, using its saved profile. [More](authentication.md#profiles) |
| 4 | `clika-cli devices list --status online` | See which devices are up right now. [More](devices.md#devices-list) |
| 5 | `clika-cli devices get jetson-01` | Inspect one device in full, by name rather than UUID. [More](devices.md#devices-get) |
| 6 | `clika-cli devices exec jetson-01 'nvidia-smi'` | Run a command on a device and get its output and exit code back. [More](devices.md#devices-exec) |
| 7 | `clika-cli devices push jetson-01 ./run.sh /opt/clika/run.sh --permissions 0755` | Copy a local file onto a device. [More](devices.md#devices-push) |
| 8 | `clika-cli devices files-fetch jetson-01 /var/log/agent.log ./agent.log` | Pull a file back off a device, checksum verified. [More](devices.md#devices-files-fetch) |
| 9 | `clika-cli devices connect jetson-01` | Open an SSH session to a device without looking up its address. [More](devices.md#devices-connect) |
| 10 | `clika-cli apply -f benchmark.yaml` | Create or update whatever a YAML file names, idempotently for definitions. [More](apply-export.md#apply) |
| 11 | `clika-cli benchmarks watch nightly-llm-sweep` | Follow a benchmark to completion and exit non-zero if any leg failed. The CI gate. [More](benchmarks.md#benchmarks-watch) |
| 12 | `clika-cli benchmarks results nightly-llm-sweep -o json` | Read a benchmark group's measured metrics, in a form a script can parse. [More](benchmarks.md#benchmarks-results) |
| 13 | `clika-cli jobs list --status failed` | Find the jobs that went wrong. [More](jobs.md#jobs-list) |
| 14 | `clika-cli jobs execution-log <job>` | Read what actually happened on the device during a job. [More](jobs.md#getting-results-back) |
| 15 | `clika-cli artifacts upload ./model.onnx --type model --version v2` | Put a file in the artifact library, resumably, however large it is. [More](artifacts.md#artifacts-upload) |
| 16 | `clika-cli artifacts download imagenet-val ./data/` | Stream an artifact back out to a local path. [More](artifacts.md#downloading) |
| 17 | `clika-cli export JobDefinition llm-latency > config.yaml` | Bring a definition authored in the dashboard into your repository. [More](apply-export.md#export) |
| 18 | `clika-cli events tail --types job_completed` | Follow the platform's durable event feed live, resumable from a cursor. [More](monitoring.md#events-tail) |
| 19 | `clika-cli mcp --toolset device-ops` | Serve the platform to an AI assistant as a curated set of tools. [More](mcp.md#mcp) |
| 20 | `clika-cli self-update` | Pull the CLI build this deployment publishes, checksum and signature verified. [More](self-update.md#self-update) |

## Flags worth knowing

| Flag | Effect |
| --- | --- |
| `-o json` | JSON instead of a table, pagination envelope included, for piping into `jq`. |
| `--profile <name>` | Address a different deployment. |
| `-y` | Answer confirmation prompts with yes. Required for a destructive delete in a script. |
| `--insecure-tls` | Skip certificate verification, for an on-premise stack with a throwaway certificate authority. |
| `--dry-run` | On `apply`, print the requests instead of sending them. |
| `--raw` | On a generated command, print the response body byte for byte. |

## When you do not know the command

```
clika-cli --help
clika-cli devices --help
clika-cli tools --tag devices
clika-cli help credentials
```

The first two walk the tree, `tools` lists every operation by tool name, and `help <topic>` prints the built-in prose guides. See the [complete command index](other-resources.md#complete-command-index) for every top-level command and the page that documents it.