feat(raycast): add Cap.so Raycast extension (#28) by frds3445 · Pull Request #3937 · CapSoftware/Cap

frds3445 · 2026-11-07T15:50:57Z

Summary

Adds the official Cap.so Raycast extension (apps/raycast-extension) enabling keyboard-first control of Cap desktop recordings (#28):

Commands for Start Recording, Stop Recording, and Open Cap Dashboard via cap:// deep links with configurable recording mode, audio/camera toggles, and fallback error handling.
Includes unit tests (src/deeplink.test.ts) verifying deep-link URL construction and parameter sanitization.

Fixes #28
/claim #28

Confidence Score: 0/5

Fix the recording defaults, device settings, clipboard result, and CI failures before merging.

Findings

Default recording never starts ▶
Microphone and camera stay off ▶
Stop reports an older link ▶
CI dependency install fails ▶
Format check fails ▶
Extension icon is missing ▶
Comments repeat the code ▶
Test accepts lost recording settings ▶

Fix with agent prompt

### Issue 1
apps/raycast-extension/src/deeplink.ts:33
`Primary` is not a desktop alias. Cap matches display names exactly, so a Mac with a display named `Built-in Retina Display` rejects the default action. Nothing records, but Raycast still announces success. Resolve a real display name or require one before sending the action.

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!

### Issue 2
apps/raycast-extension/src/deeplink.ts:40-41
`cameraDeviceId` and `micLabel` have no entries in the extension preferences, so users cannot set either value. Every command sends `camera: null` and `mic_label: null`. Cap clears both inputs instead of keeping the devices selected in the desktop app. Add preferences for these inputs or use a desktop action that preserves the selected devices.

### Issue 3
apps/raycast-extension/src/stop-recording.ts:23-30
Cap stops in the background and writes the new link only after that work finishes. Reading the clipboard immediately after opening the stop link can return an older Cap URL, which this command copies and reports as the current result. Studio recordings do not produce a share link on stop at all. Wait for a result tied to this recording, or leave copying to Cap without claiming that existing clipboard text is the new result.

### Issue 4
apps/raycast-extension/package.json:88-95
This adds a workspace and dependencies without updating `bun.lock`. The root includes `apps/*`, and CI installs with `bun install --frozen-lockfile`. Because the new workspace is absent from the lockfile, the shared install step fails before the checks run. Regenerate and commit `bun.lock` with this manifest.

### Issue 5
apps/raycast-extension/package.json:2-6
The new files use spaces instead of tabs. `AGENTS.md` requires tab indentation for new TypeScript and JSON files, and CI enforces the root Biome configuration. Format this extension with that configuration. The same issue appears in `tsconfig.json`, `src/deeplink.ts`, and elsewhere in the extension.

### Issue 6
apps/raycast-extension/package.json:6
The manifest names `extension-icon.png`, but the extension contains no image or assets directory. Add the referenced icon so Raycast has an image to display and package.

### Issue 7
apps/raycast-extension/src/deeplink.ts:61
`AGENTS.md` bans comments that merely describe what the code does. This comment repeats `buildStopRecordingDeepLink` without adding context. Remove these comments before merging to meet that requirement. The same issue appears above `buildStartRecordingDeepLink` and `resolveDashboardUrl`, and in the command files.

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!

### Issue 8
apps/raycast-extension/src/deeplink.test.ts:30-34
This test passes `payload.start_recording` where `buildStartRecordingDeepLink` expects preferences. It then expects the fallback `instant` mode despite configuring `studio`. The `as any` hides the wrong input type and violates `AGENTS.md`’s requirement to avoid `any`. Before merging, pass the original typed preferences and assert that the decoded URL preserves the mode, screen, devices, and audio setting.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Summary

Adds a Raycast extension with commands to start recordings, stop recordings, and open the web dashboard.

Raycast starts Cap recordings with saved capture settings.
Raycast stops Cap recordings and can copy their share links.
Raycast opens the configured Cap dashboard in a browser.

_{Reviews (1) · Last reviewed commit: "feat(raycast): add official Cap.so Rayca..." · Reviewed by Greptile}

- Add Raycast extension under `apps/raycast-extension` supporting `start-recording`, `stop-recording`, and `open-dashboard` commands. - Implement `cap-desktop://action?value=...` deep-link builders matching the `DeepLinkAction` serde grammar in `apps/desktop-gpui/src/deeplink.rs`. - Add unit tests verifying `start_recording`, `stop_recording`, dashboard URL normalization, and shareable URL clipboard handling. Fixes CapSoftware#28 Signed-off-by: Lucas Oliveira <kalopsia3445@gmail.com>

vercel · 2026-11-07T15:51:03Z

@frds3445 is attempting to deploy a commit to the Cap Software Inc Team on Vercel.

A member of the Team first needs to authorize it.

Copilot

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota. Try requesting a review at a lower effort level.

An organization owner can choose the repository organization as the billing source for reviews requested by members with a paid Copilot license. Learn about Copilot code review billing.

greptile-apps · 2026-11-07T15:53:56Z

+export function buildStartRecordingPayload(
+    prefs: StartRecordingPreferences
+): DeepLinkStartPayload {
+    const screenName = (prefs.defaultScreen || "Primary").trim() || "Primary"


Default recording never starts

Primary is not a desktop alias. Cap matches display names exactly, so a Mac with a display named Built-in Retina Display rejects the default action. Nothing records, but Raycast still announces success. Resolve a real display name or require one before sending the action.

Prompt To Fix With AI

This is a comment left during a code review. Path: apps/raycast-extension/src/deeplink.ts Line: 33 Comment: **Default recording never starts** `Primary` is not a desktop alias. Cap matches display names exactly, so a Mac with a display named `Built-in Retina Display` rejects the default action. Nothing records, but Raycast still announces success. Resolve a real display name or require one before sending the action. --- 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!

greptile-apps · 2026-11-07T15:53:56Z

+            camera: cameraId ? { DeviceID: cameraId } : null,
+            mic_label: micName || null,


Microphone and camera stay off

cameraDeviceId and micLabel have no entries in the extension preferences, so users cannot set either value. Every command sends camera: null and mic_label: null. Cap clears both inputs instead of keeping the devices selected in the desktop app. Add preferences for these inputs or use a desktop action that preserves the selected devices.

Prompt To Fix With AI

This is a comment left during a code review. Path: apps/raycast-extension/src/deeplink.ts Line: 40-41 Comment: **Microphone and camera stay off** `cameraDeviceId` and `micLabel` have no entries in the extension preferences, so users cannot set either value. Every command sends `camera: null` and `mic_label: null`. Cap clears both inputs instead of keeping the devices selected in the desktop app. Add preferences for these inputs or use a desktop action that preserves the selected devices. --- For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

greptile-apps · 2026-11-07T15:53:57Z

+        const existingText = await Clipboard.readText()
+        const shareUrl = extractShareableCapUrl(
+            existingText,
+            prefs.dashboardUrl
+        )
+        if (shareUrl) {
+            await Clipboard.copy(shareUrl)
+            await showHUD(`Cap recording stopped — copied ${shareUrl}`)


Stop reports an older link

Cap stops in the background and writes the new link only after that work finishes. Reading the clipboard immediately after opening the stop link can return an older Cap URL, which this command copies and reports as the current result. Studio recordings do not produce a share link on stop at all. Wait for a result tied to this recording, or leave copying to Cap without claiming that existing clipboard text is the new result.

Prompt To Fix With AI

This is a comment left during a code review. Path: apps/raycast-extension/src/stop-recording.ts Line: 23-30 Comment: **Stop reports an older link** Cap stops in the background and writes the new link only after that work finishes. Reading the clipboard immediately after opening the stop link can return an older Cap URL, which this command copies and reports as the current result. Studio recordings do not produce a share link on stop at all. Wait for a result tied to this recording, or leave copying to Cap without claiming that existing clipboard text is the new result. --- For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

greptile-apps · 2026-11-07T15:53:57Z

+  "dependencies": {
+    "@raycast/api": "^1.83.1"
+  },
+  "devDependencies": {
+    "@raycast/eslint-config": "^1.0.11",
+    "@types/node": "20.8.10",
+    "typescript": "^5.4.5",
+    "vitest": "^2.1.0"


CI dependency install fails

This adds a workspace and dependencies without updating bun.lock. The root includes apps/*, and CI installs with bun install --frozen-lockfile. Because the new workspace is absent from the lockfile, the shared install step fails before the checks run. Regenerate and commit bun.lock with this manifest.

Prompt To Fix With AI

This is a comment left during a code review. Path: apps/raycast-extension/package.json Line: 88-95 Comment: **CI dependency install fails** This adds a workspace and dependencies without updating `bun.lock`. The root includes `apps/*`, and CI installs with `bun install --frozen-lockfile`. Because the new workspace is absent from the lockfile, the shared install step fails before the checks run. Regenerate and commit `bun.lock` with this manifest. --- For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

greptile-apps · 2026-11-07T15:53:57Z

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


Extension icon is missing

The manifest names extension-icon.png, but the extension contains no image or assets directory. Add the referenced icon so Raycast has an image to display and package.

Prompt To Fix With AI

This is a comment left during a code review. Path: apps/raycast-extension/package.json Line: 6 Comment: **Extension icon is missing** The manifest names `extension-icon.png`, but the extension contains no image or assets directory. Add the referenced icon so Raycast has an image to display and package. --- For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

greptile-apps · 2026-11-07T15:53:57Z

+  "$schema": "https://www.raycast.com/schemas/extension.json",
+  "name": "cap-raycast",
+  "title": "Cap Screen Recorder",
+  "description": "Start and stop Cap recordings and open your Cap web dashboard directly from Raycast.",
+  "icon": "extension-icon.png",


Format check fails

The new files use spaces instead of tabs. AGENTS.md requires tab indentation for new TypeScript and JSON files, and CI enforces the root Biome configuration. Format this extension with that configuration. The same issue appears in tsconfig.json, src/deeplink.ts, and elsewhere in the extension.

Context Used: CLAUDE.md (source)

Prompt To Fix With AI

This is a comment left during a code review. Path: apps/raycast-extension/package.json Line: 2-6 Comment: **Format check fails** The new files use spaces instead of tabs. `AGENTS.md` requires tab indentation for new TypeScript and JSON files, and CI enforces the root Biome configuration. Format this extension with that configuration. The same issue appears in `tsconfig.json`, `src/deeplink.ts`, and elsewhere in the extension. **Context Used:** CLAUDE.md ([source](https://github.com/capsoftware/cap/blob/main/CLAUDE.md)) --- For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

greptile-apps · 2026-11-07T15:53:57Z

+    return encodeCapActionUrl(buildStartRecordingPayload(prefs))
+}
+
+// Builds the cap-desktop:// deep link URL to stop an active recording.


Comments repeat the code

AGENTS.md bans comments that merely describe what the code does. This comment repeats buildStopRecordingDeepLink without adding context. Remove these comments before merging to meet that requirement. The same issue appears above buildStartRecordingDeepLink and resolveDashboardUrl, and in the command files.

Context Used: CLAUDE.md (source)

Prompt To Fix With AI

This is a comment left during a code review. Path: apps/raycast-extension/src/deeplink.ts Line: 61 Comment: **Comments repeat the code** `AGENTS.md` bans comments that merely describe what the code does. This comment repeats `buildStopRecordingDeepLink` without adding context. Remove these comments before merging to meet that requirement. The same issue appears above `buildStartRecordingDeepLink` and `resolveDashboardUrl`, and in the command files. **Context Used:** CLAUDE.md ([source](https://github.com/capsoftware/cap/blob/main/CLAUDE.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!

greptile-apps · 2026-11-07T15:53:57Z

+        const url = new URL(buildStartRecordingDeepLink(payload.start_recording as any))
+        expect(url.protocol).toBe("cap-desktop:")
+        expect(url.host).toBe("action")
+        const decoded = JSON.parse(url.searchParams.get("value") || "{}")
+        expect(decoded.start_recording.mode).toBe("instant")


Test accepts lost recording settings

This test passes payload.start_recording where buildStartRecordingDeepLink expects preferences. It then expects the fallback instant mode despite configuring studio. The as any hides the wrong input type and violates AGENTS.md’s requirement to avoid any. Before merging, pass the original typed preferences and assert that the decoded URL preserves the mode, screen, devices, and audio setting.

Context Used: CLAUDE.md (source)

Prompt To Fix With AI

This is a comment left during a code review. Path: apps/raycast-extension/src/deeplink.test.ts Line: 30-34 Comment: **Test accepts lost recording settings** This test passes `payload.start_recording` where `buildStartRecordingDeepLink` expects preferences. It then expects the fallback `instant` mode despite configuring `studio`. The `as any` hides the wrong input type and violates `AGENTS.md`’s requirement to avoid `any`. Before merging, pass the original typed preferences and assert that the decoded URL preserves the mode, screen, devices, and audio setting. **Context Used:** CLAUDE.md ([source](https://github.com/capsoftware/cap/blob/main/CLAUDE.md)) --- For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

…ion, and clipboard polling Sync apps/raycast-extension in bun.lock, use official Cap dock icon, auto-detect active macOS display when defaultScreen is unset, poll for fresh clipboard share links on stop, and format with Biome tabs.

Copilot AI balanced review requested due to automatic review settings November 7, 2026 15:50

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

Copilot AI reviewed Nov 7, 2026

greptile-apps Bot reviewed Nov 7, 2026

View reviewed changes

Navigation Menu

Repository navigation

feat(raycast): add Cap.so Raycast extension (#28) - #3937

feat(raycast): add Cap.so Raycast extension (#28)#3937
frds3445 wants to merge 2 commits into
CapSoftware:mainfrom
frds3445:feat/issue-28-raycast-extension

frds3445 commented Nov 7, 2026 •

edited by greptile-apps Bot

Loading

Uh oh!

vercel Bot commented Nov 7, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

greptile-apps Bot Nov 7, 2026

Uh oh!

greptile-apps Bot Nov 7, 2026

Uh oh!

greptile-apps Bot Nov 7, 2026

Uh oh!

greptile-apps Bot Nov 7, 2026

Uh oh!

greptile-apps Bot Nov 7, 2026

Uh oh!

greptile-apps Bot Nov 7, 2026

Uh oh!

greptile-apps Bot Nov 7, 2026

Uh oh!

greptile-apps Bot Nov 7, 2026

Uh oh!

This branch has not been deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

		camera: cameraId ? { DeviceID: cameraId } : null,
		mic_label: micName \|\| null,

Conversation

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

Uh oh!

Summary

Confidence Score: 0/5

Findings

Summary

Uh oh!

vercel Bot commented Nov 7, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

greptile-apps Bot Nov 7, 2026

Choose a reason for hiding this comment

Uh oh!

greptile-apps Bot Nov 7, 2026

Choose a reason for hiding this comment

Uh oh!

greptile-apps Bot Nov 7, 2026

Choose a reason for hiding this comment

Uh oh!

greptile-apps Bot Nov 7, 2026

Choose a reason for hiding this comment

Uh oh!

greptile-apps Bot Nov 7, 2026

Choose a reason for hiding this comment

Uh oh!

greptile-apps Bot Nov 7, 2026

Choose a reason for hiding this comment

Uh oh!

greptile-apps Bot Nov 7, 2026

Choose a reason for hiding this comment

Uh oh!

greptile-apps Bot Nov 7, 2026

Choose a reason for hiding this comment

Uh oh!

This branch has not been deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

frds3445 commented Nov 7, 2026 •

edited by greptile-apps Bot

Loading