CtrlK
BlogDocsLog inGet started
Tessl Logo

recording

Capture screenshots on registered computers, record on macOS or HarmonyOS, and manage saved captures. Probe capabilities before recording.

62

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./crates/tui/plugins/computer-use/skills/recording/SKILL.md
SKILL.md
Quality
Evals
Security

Recording and screenshots

  1. Pick the computer (computer_list, or pass computer — it switches).
  2. Check request_access when readiness is unknown. On a supported target, use recording_start with optional display, region, fps and durationSec (macOS auto-stop), or intervalMs (HarmonyOS snapshot cadence).
  3. Do the work (or let the user do it).
  4. recording_stop with the returned id → finalized file path + bytes.
  5. recording_list shows everything saved; recording_status checks one.

Platform truths:

  • macOS: ScreenCaptureKit inside the signed helper captures a display or region straight to .mov — no system recorder selection UI and no desktop dimming overlay. If capture is denied, Screen Recording permission is missing for whoever ran it: the Codewhale Computer Use app when request_access says via: "app", else the terminal that hosts the server — tell the user which, do not retry.
  • Windows and Linux: recording is unavailable pending session-owned recorder cleanup. Use screenshots; installing ffmpeg does not enable it.
  • HarmonyOS: no native CLI recorder; the backend captures snapshot_display frames at intervalMs and muxes with ffmpeg on stop. The receipt labels the mode snapshot-series — never call it real-time.

Screenshots: screenshot returns the saved path and raster geometry; zoom crops the latest raster when a target is too small to read.

Repository
Hmbown/Codewhale
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.