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
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
Interact with the opened browser to demonstrate the behavior. Then stop and upload:
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:
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
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.
CLI video does not have element-level redaction. Record public pages or synthetic data, and review the actual video before sharing it.
Inspect a capture
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. 
