DocsCLI

The CLI

Capture screenshots directly from your terminal. Run any preset created on the dashboard — the CLI launches a local browser and executes the opcode program deterministically.

Quick start

The default setup path is a single init command. Generate a CLI key in the dashboard, then run:

Shell
npx autokap@latest init --cli-key <your-cli-key>

Optional installers if you prefer a global binary:

Shell
curl -fsSL https://autokap.app/install.sh | sh
Shell
irm https://autokap.app/install.ps1 | iex

Install

Global install is optional. The CLI-first setup above works without it.

Shell
npm install -g autokap

One-step setup

init authenticates the CLI and installs the default preset skill in one step.

Shell
npx autokap@latest init --cli-key <your-cli-key>

Advanced: use npx autokap@latest skill --agent <agent> only when you want an agent-specific export outside the default init flow.

Run a preset

AutoKap capture execution is CLI-first. Run presets locally via Playwright after the preset has been created or updated.

Shell
autokap run <preset-id>
Shell
autokap run --local <preset-id>

Use --program <file> only as a local debug override. The normal path is to run the saved preset directly.

Commands

CommandDescription
autokap initAuthenticate and install the AI skill in one step
autokap login <key>Authenticate with your CLI key
autokap logoutRemove stored credentials
autokap whoamiShow the account linked to the current CLI key
autokap pingVerify CLI connection and confirm the stored key is still valid
autokap run <preset-id>Run a preset capture using local Playwright
autokap run <preset-id> --headedShow the browser window for debugging
autokap project listList accessible projects as JSON
autokap project get <project-id>Get a single project as JSON
autokap project create --name <name> --url <url>Create a project and print its ID
autokap preset info <preset-id>Get structured JSON with endpoints, variants, and URL parameters
autokap capture listList captures as JSON
autokap usageShow the current billing-period usage as JSON
autokap endpoints list --preset <id>List dev link endpoints as JSON or table
autokap endpoints get <endpoint-id>Get a single dev link endpoint as JSON
autokap endpoints export --preset <id>Export dev link endpoints as JSON or CSV
autokap auth capture <project-id>Capture a browser session for a session account
autokap auth account list <project-id>List project credential accounts as JSON
autokap auth account create <project-id> --name <name>Create a project credential account and print its ID
autokap auth account update <project-id> --account <name-or-id>Update a project credential account
autokap auth account delete <project-id> --account <name-or-id>Delete an unused project credential account
autokap auth session clear <project-id> --account <name-or-id>Clear the stored browser session for a session account
autokap proxy register --project <id> --proxy-url <url>Register a user-side proxy for dev links
autokap proxy verify --project <id>Verify the configured proxy for a project
autokap skillExport the AI agent skill bundle
autokap --versionShow the installed version

How it works

  1. Generate a CLI key from the dashboard.
  2. Run npx autokap@latest init --cli-key <your-cli-key> once in your repo.
  3. Create or update presets, then run them with autokap run.