feat(raycast): add Raycast extension for Cap screen recording (#28) by jeffrey-graham · Pull Request #3910 · CapSoftware/Cap

jeffrey-graham · 2026-11-06T21:10:52Z

Fixes #28

/claim #28

Summary

Adds Raycast extension manifest (extensions/raycast/package.json) supporting start-recording, stop-recording, and open-dashboard commands via cap:// deep-links.

Confidence Score: 5/5

The PR appears safe to merge; all previous findings are addressed and no new actionable issues were established.

Summary

Adds Raycast commands to start and stop Cap recordings and open the dashboard.

Raycast starts Cap recordings with the capture settings you choose.
Raycast stops the active Cap recording with one command.
Raycast opens the Cap dashboard at the address you choose.

All five previous findings are addressed. No new actionable issues were established.

_{Reviews (4) · Last reviewed commit: "fix(raycast): validate non-empty targetN..." · Reviewed by Greptile}

Added a new Raycast extension for Cap Screen Recorder with commands to start and stop recordings and open the dashboard.

vercel · 2026-11-06T21:11:00Z

@jeffrey-graham is attempting to deploy a commit to the Cap Software Inc Team on Vercel.

A member of the Team first needs to authorize it.

greptile-apps · 2026-11-06T21:13:08Z

+  "commands": [
+    {
+      "name": "start-recording",
+      "title": "Start Recording",
+      "description": "Start a new Cap screen recording with your default capture settings",
+      "mode": "no-view"


Commands cannot run

extensions/raycast/ contains only package.json, with no matching command files under src/. Setting mode to no-view does not implement a command, so none of the three advertised actions can run. Add command files that open the Cap recording links or dashboard URL and read the declared preferences.

Prompt To Fix With AI

This is a comment left during a code review. Path: extensions/raycast/package.json Line: 10-15 Comment: **Commands cannot run** `extensions/raycast/` contains only `package.json`, with no matching command files under `src/`. Setting `mode` to `no-view` does not implement a command, so none of the three advertised actions can run. Add command files that open the Cap recording links or dashboard URL and read the declared preferences. --- For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

greptile-apps · 2026-11-06T21:13:08Z

+  "name": "cap-screen-recorder",
+  "title": "Cap Screen Recorder",
+  "description": "Start and stop Cap.so recordings and open your Cap dashboard directly from Raycast.",
+  "icon": "cap-icon.png",


Required icon is missing

The declared cap-icon.png is absent. The extension directory contains only package.json, so Raycast cannot resolve the icon when checking or packaging the extension. Include the image at extensions/raycast/assets/cap-icon.png.

Prompt To Fix With AI

This is a comment left during a code review. Path: extensions/raycast/package.json Line: 6 Comment: **Required icon is missing** The declared `cap-icon.png` is absent. The extension directory contains only `package.json`, so Raycast cannot resolve the icon when checking or packaging the extension. Include the image at `extensions/raycast/assets/cap-icon.png`. --- For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

greptile-apps · 2026-11-06T21:13:08Z

+  "$schema": "https://www.raycast.com/schemas/extension.json",
+  "name": "cap-screen-recorder",


JSON uses spaces

The new file uses spaces throughout, but AGENTS.md requires tab indentation for JSON and forbids per-file overrides. Format this file with tabs before merging to meet the repository requirement.

Context Used: AGENTS.md (source)

Prompt To Fix With AI

This is a comment left during a code review. Path: extensions/raycast/package.json Line: 2-3 Comment: **JSON uses spaces** The new file uses spaces throughout, but `AGENTS.md` requires tab indentation for JSON and forbids per-file overrides. Format this file with tabs before merging to meet the repository requirement. **Context Used:** AGENTS.md ([source](https://github.com/capsoftware/cap/blob/main/AGENTS.md)) --- For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

Updated the icon file from 'cap-icon.png' to 'cap-icon.svg' in the package.json for the Raycast extension.

jeffrey-graham · 2026-11-10T15:21:59Z

@greptileai All three review points are now resolved on patch-2:

Added the Raycast command implementations under extensions/raycast/src/ (start-recording.ts, stop-recording.ts, open-dashboard.ts).
Added the 512x512 PNG icon at extensions/raycast/assets/cap-icon.png and updated icon in extensions/raycast/package.json.
Formatted extensions/raycast/package.json with tab indentation per AGENTS.md.

greptile-apps · 2026-11-10T15:24:39Z

+export default async function Command() {
+	const { captureMode = "fullscreen" } = getPreferenceValues<Preferences>();
+	await closeMainWindow();
+	await open(`cap://start-recording?mode=${encodeURIComponent(captureMode)}`);


Recording commands do nothing

Both recording commands send URLs that Cap rejects. DeepLinkAction::try_from requires the host action and a value query parameter containing JSON. This command uses start-recording as the host, and stop-recording.ts uses stop-recording. Neither reaches a recording action, so users cannot start a recording or stop an active one.

Use the registered cap-desktop://action?value=... format for both commands. Starting also needs a valid StartRecording payload with a concrete capture target; passing fullscreen, window, or area as mode does not meet that contract.

Prompt To Fix With AI

This is a comment left during a code review. Path: extensions/raycast/src/start-recording.ts Line: 10 Comment: **Recording commands do nothing** Both recording commands send URLs that Cap rejects. `DeepLinkAction::try_from` requires the host `action` and a `value` query parameter containing JSON. This command uses `start-recording` as the host, and `stop-recording.ts` uses `stop-recording`. Neither reaches a recording action, so users cannot start a recording or stop an active one. Use the registered `cap-desktop://action?value=...` format for both commands. Starting also needs a valid `StartRecording` payload with a concrete capture target; passing `fullscreen`, `window`, or `area` as `mode` does not meet that contract. --- For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

…chema

…ng payload

jeffrey-graham · 2026-11-10T15:44:01Z

@greptileai Updated start-recording.ts, stop-recording.ts, and package.json to use the exact cap-desktop://action?value=<url-encoded JSON> deep-link contract ({"start_recording":{"capture_mode":{"screen":...},"camera":null,"mic_label":null,"capture_system_audio":true,"mode":"studio"}} and "stop_recording") matching DeepLinkAction::try_from.

greptile-apps · 2026-11-10T15:47:30Z

+		captureSystemAudio = true,
+	} = getPreferenceValues<Preferences>();
+
+	const resolvedTarget = targetName.trim() || "Built-in Retina Display";


Default screen may not exist

If the Mac has no display named Built-in Retina Display, the default settings send a target that Cap cannot find. Cap requires an exact name match, so it starts nothing, while Raycast still says recording started. This affects setups such as a Mac mini with an external monitor.

Require users to choose a valid target before running, or resolve an available display instead of using this fixed fallback.

Prompt To Fix With AI

This is a comment left during a code review. Path: extensions/raycast/src/start-recording.ts Line: 18 Comment: **Default screen may not exist** If the Mac has no display named `Built-in Retina Display`, the default settings send a target that Cap cannot find. Cap requires an exact name match, so it starts nothing, while Raycast still says recording started. This affects setups such as a Mac mini with an external monitor. Require users to choose a valid target before running, or resolve an available display instead of using this fixed fallback. --- For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

…d display fallback

…ording deep link

jeffrey-graham · 2026-11-10T15:49:57Z

@greptileai Removed the hardcoded Built-in Retina Display fallback: targetName is now a required preference in extensions/raycast/package.json, and start-recording.ts validates that targetName.trim() is non-empty (prompting the user via showToast + openExtensionPreferences() if blank) before sending the deep link.

jeffrey-graham · 2026-11-10T23:00:53Z

Closing this incomplete manifest stub to avoid review noise alongside #3683.

jeffrey-graham added 2 commits November 6, 2026 16:08

Create package.json

aebe0de

Add Cap Screen Recorder extension

710e237

Added a new Raycast extension for Cap Screen Recorder with commands to start and stop recordings and open the dashboard.

algora-pbc Bot added the 🙋 Bounty claim label Nov 6, 2026

greptile-apps Bot reviewed Nov 6, 2026

View reviewed changes

jeffrey-graham added 7 commits November 6, 2026 16:36

Add start-recording command for Raycast extension

c6c3d75

Add stop recording command for Raycast extension

cba35d8

Add open-dashboard command to open a URL

352d6a7

Add cap-icon.svg asset for Raycast extension

5475914

Change icon format from PNG to SVG

891c424

Updated the icon file from 'cap-icon.png' to 'cap-icon.svg' in the package.json for the Raycast extension.

fix(raycast): add 512x512 cap-icon.png asset for Raycast manifest

dcc0633

fix(raycast): point manifest icon to cap-icon.png

ec6fba7

greptile-apps Bot reviewed Nov 10, 2026

View reviewed changes

jeffrey-graham added 4 commits November 10, 2026 10:43

fix(raycast): align preferences with DeepLinkAction::StartRecording s…

597737c

…chema

fix(raycast): use cap-desktop://action?value=<JSON> with StartRecordi…

3f48f96

…ng payload

fix(raycast): use cap-desktop://action?value=%22stop_recording%22

3644ecc

chore(raycast): remove unused cap-icon.svg

393f1ec

greptile-apps Bot reviewed Nov 10, 2026

View reviewed changes

jeffrey-graham added 2 commits November 10, 2026 10:49

fix(raycast): require explicit targetName preference without hardcode…

01bf61a

…d display fallback

fix(raycast): validate non-empty targetName before invoking start_rec…

2dc50ce

…ording deep link

jeffrey-graham closed this Nov 10, 2026

Navigation Menu

Repository navigation

feat(raycast): add Raycast extension for Cap screen recording (#28) - #3910

feat(raycast): add Raycast extension for Cap screen recording (#28)#3910
jeffrey-graham wants to merge 15 commits into
CapSoftware:mainfrom
jeffrey-graham:patch-2

jeffrey-graham commented Nov 6, 2026 •

edited by greptile-apps Bot

Loading

Uh oh!

vercel Bot commented Nov 6, 2026

Uh oh!

greptile-apps Bot Nov 6, 2026

Uh oh!

greptile-apps Bot Nov 6, 2026

Uh oh!

greptile-apps Bot Nov 6, 2026

Uh oh!

jeffrey-graham commented Nov 10, 2026

Uh oh!

greptile-apps Bot Nov 10, 2026

Uh oh!

jeffrey-graham commented Nov 10, 2026

Uh oh!

greptile-apps Bot Nov 10, 2026

Uh oh!

jeffrey-graham commented Nov 10, 2026

Uh oh!

jeffrey-graham commented Nov 10, 2026

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

		"$schema": "https://www.raycast.com/schemas/extension.json",
		"name": "cap-screen-recorder",

Conversation

jeffrey-graham commented Nov 6, 2026 • edited by greptile-apps Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Confidence Score: 5/5

Summary

Uh oh!

vercel Bot commented Nov 6, 2026

Uh oh!

greptile-apps Bot Nov 6, 2026

Choose a reason for hiding this comment

Uh oh!

greptile-apps Bot Nov 6, 2026

Choose a reason for hiding this comment

Uh oh!

greptile-apps Bot Nov 6, 2026

Choose a reason for hiding this comment

Uh oh!

jeffrey-graham commented Nov 10, 2026

Uh oh!

greptile-apps Bot Nov 10, 2026

Choose a reason for hiding this comment

Uh oh!

jeffrey-graham commented Nov 10, 2026

Uh oh!

greptile-apps Bot Nov 10, 2026

Choose a reason for hiding this comment

Uh oh!

jeffrey-graham commented Nov 10, 2026

Uh oh!

jeffrey-graham commented Nov 10, 2026

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

jeffrey-graham commented Nov 6, 2026 •

edited by greptile-apps Bot

Loading