Docs

Command line

The klio commands for running, deploying and managing work, and the options agents and scripts need.

For agents: this page as markdown

Overview

Installing klio-compute also installs the klio command. klio --help lists every command, and --help after a command explains it.

The commands these docs use
CommandWhat it does
klio loginSign in, or create an account. --browserless prints a link and a code instead of opening a browser.
klio run app.pyRun a file's local entrypoint, or its only function.
klio deploy app.pyDeploy every function and class in a file's App, or one handler as app.py:handler.
klio gpusEvery GPU type, its price per hour right now, and whether it can start. Add --json for JSON.
klio model deployDeploy an open model behind an OpenAI-compatible API. klio model list shows the models.
klio migrate --checkCheck a Modal project before changing anything. --write changes its import lines.
klio app listList running apps. info, logs and stop work on one app.
klio deployment listList deployments. klio deployment stop stops one by its id.
klio task listList tasks. klio task stop stops one.
klio volume listList volumes. create, put, get, ls, cp and delete work on them.
klio secret listList secrets. create, show and delete work on them.
klio curlCall a private endpoint with your key.
klio logsRead or follow workload logs.
klio doctorCheck your connection and credentials.
klio dashboardOpen the console.

For agents and scripts

  • --json gives machine-readable output, and errors come with a code. It implies --no-input.
  • --no-input turns off prompts.
  • klio login --browserless signs in from a shell without a browser; KLIO_TOKEN skips sign-in entirely.
  • Several workspaces: klio login --name NAME saves a sign-in under its own context, and --context NAME picks it.

© 2026 Klio