> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tekma.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the CLI and record a website

> Install the Tekma capture CLI, authenticate, record a browser, and upload a shareable video with automatic chapters.

The Tekma CLI is named `capture`. It can inspect existing captures and record a browser walkthrough with video and diagnostic events.

## Requirements

* Node.js 22.17 or newer.
* FFmpeg available on your command path.
* Chrome or Chromium installed for browser recording.
* A Tekma account with recording permission, unless using local mode or an authorized recording link.

## Install and sign in

```bash theme={null}
npm install --global https://tekma.dev/downloads/tekma-cli.tgz
export CAPTURE_MCP_URL=https://mcp.tekma.dev/mcp
capture auth login --scope captures:record
capture auth status
```

Keep the login command running while approving access in the browser. Choose the intended account. Normal login requests read access; `captures:record` adds recording uploads.

## Record a new browser

```bash theme={null}
capture record open https://example.com --headed
capture record status
```

Interact with the opened browser to demonstrate the behavior. Then stop and upload:

```bash theme={null}
capture record stop --title "Example website walkthrough"
```

`record open` launches the browser and starts recording immediately. `--headed` makes the window visible; omit it for a headless workflow controlled by your automation tooling.

The stop result reports upload status, capture URLs, duration, and recorded frame information. Workspace policy can withhold a public share URL; check `shareUnavailableReason` if one is not returned.

## Record an existing automation browser

If your tooling exposes an authorized Chromium DevTools endpoint:

```bash theme={null}
capture record start --cdp http://127.0.0.1:9222
# Perform the walkthrough in that browser.
capture record stop --title "Checkout regression verification"
```

Use the endpoint from your browser tooling. Do not expose a debugging port publicly. The recorder attaches to the browser session instead of creating an unrelated recording window.

## Save locally without uploading

```bash theme={null}
capture record open https://example.com --headed --local
capture record stop --title "Local walkthrough"
```

Local mode needs no Tekma login. Stop returns local video and events paths instead of a share URL. Copy the files you want to keep before starting another recording in the same recorder directory.

<Warning>
  CLI video does not have element-level redaction. Record public pages or synthetic data, and review the actual video before sharing it.
</Warning>

## Inspect a capture

```bash theme={null}
capture get capture CAPTURE_ID
capture get diagnosis CAPTURE_ID
capture get console CAPTURE_ID --level error
capture get network CAPTURE_ID --failed-only
capture agent-context
```

Replace `CAPTURE_ID` with your capture's identifier or supported capture URL. `agent-context` returns the command catalog for automation. Use `capture --help` for the installed version's options.

## Finish and verify

Open the returned capture or share URL. Play the video, confirm the intended actions are visible, and allow time for chapters and streaming variants to finish processing. Run `capture auth logout` when you want to forget the stored credential.