| name | wrec-screen-recording |
| description | Record the screen with wrec. Use when the user wants a screen recording, sample video, display/window/app capture, system-audio capture, cursor or Wrec-window visibility control, recording job control, output lookup, or wrec CLI usage. |
Wrec Screen Recording
Operate wrec as the recorder. A run is complete only when the recording job is no longer active, the output file exists, and the final path has been reported.
Process
-
Read references/wrec-usage.md.
Completion: know the executable path, target selector, options, and verification commands for this run.
-
Resolve wrec and current state.
Prefer the local repo build when present, otherwise use wrec from PATH. If a recording may already be running, inspect jobs before starting another.
Completion: one executable is selected and there is no unmanaged active job.
-
Select one target.
If the target is ambiguous, list targets and choose the primary display for a sample recording, or the matching display/window/app when the user named one.
Completion: exactly one target selector is chosen.
-
Record with a bounded command.
Use --duration unless the user explicitly wants an ongoing detached recording. Apply requested audio, cursor, codec, resolution, quality, output folder, and hide-Wrec options.
Completion: wrec accepted the command and the job id or output path is known.
-
Verify the recording.
Inspect jobs, confirm no active job remains, confirm the completed status, and check the output file exists with non-zero length. If audio was requested, probe for an audio track when possible.
Completion: verification passed, or the failing job logs have been read and the actionable error is known.
-
Report the result.
Include output path, target, duration, resolution/codec when known, cursor/audio settings, and completion status.
Defaults
For an unspecified sample recording, use the primary display for 5s, 1080p, balanced, h264, cursor on, system audio off. Use native resolution when the user asks for exact full-size capture.
