feat: Add Raycast Extension with Enhanced Deeplink Support (#1540) - #1566
feat: Add Raycast Extension with Enhanced Deeplink Support (#1540)#15661234-ad wants to merge 17 commits into
Conversation
![greptile-apps[bot]](https://avatars.githubusercontent.com/in/867647?s=60&v=4){kind=small}
![tembo[bot]](https://avatars.githubusercontent.com/in/1223475?s=60&v=4){kind=small}
|
Closing this along with the deeplinks and Raycast bounty (#1540), which we are not pursuing. Since that issue was opened we shipped the Cap CLI, which covers this need more completely than deeplinks would have: cap record starts and stops recordings, cap targets lists screens, windows and devices, plus screenshot, export, upload and library commands, all with --json output, and cap mcp for driving Cap from an agent. A Raycast extension can be built directly on the CLI, which is a better foundation than a URL scheme. This is not a reflection on your work, and leaving it unreviewed for this long is our failure. Sorry for the wasted effort, and thank you for taking the time. If you want to contribute again, the open bug reports are the most useful place and we will review promptly. |
2 participants
Description
This PR implements a complete Raycast extension for Cap with enhanced deeplink support, addressing issue #1540 ($200 bounty).
Changes
1. Raycast Extension (
raycast-extension/)Created a full-featured Raycast extension with 7 commands:
2. Enhanced Deeplink Actions (
apps/desktop/src-tauri/src/deeplink_actions.rs)Extended the deeplink protocol with new actions:
PauseRecording: Pause the current recordingResumeRecording: Resume a paused recordingSwitchCamera: Change camera inputSwitchMicrophone: Change microphone inputFeatures
✅ Complete Deeplink Support
✅ User-Friendly Interface
✅ Device Enumeration
✅ Documentation
Technical Details
Deeplink Protocol
Uses
cap://action?value=<encoded_json>to communicate with Cap app.Example:
File Structure
Testing
Tested on macOS with:
Dependencies
@raycast/api: ^1.65.0@raycast/utils: ^1.12.0Installation
raycast-extension/npm installnpm run devto load in RaycastFuture Enhancements
Potential improvements:
Closes
Closes #1540
Bounty
This PR fulfills all requirements for the $200 bounty:
Note: The Rust backend changes (pause/resume, switch camera/mic) are included and ready to use. The extension gracefully handles cases where these features might not be available yet in the running Cap instance.
Greptile Overview
Greptile Summary
This PR adds a Raycast extension for Cap with enhanced deeplink support for recording control and device switching. The implementation includes 7 commands (start/stop recording, pause/resume, switch camera/mic, open settings) and extends the Rust backend with new deeplink actions.
Critical Issues Found:
set_camera_inputis called with 4 parameters but only accepts 3 (deeplink_actions.rs:127, 167)start-recording.tsxandstart-recording-window.tsxconstruct action objects without the requiredstart_recordingwrapper key to match Rust'sDeepLinkActionenumStyle Issues:
What Works Well:
The PR demonstrates good effort and documentation, but the critical bugs will prevent it from working correctly until fixed.
Confidence Score: 1/5
Important Files Changed
Sequence Diagram
sequenceDiagram participant User participant Raycast participant Extension as Raycast Extension participant System as macOS System participant Cap as Cap Desktop App participant Rust as Rust Backend participant Recording as Recording Module User->>Raycast: Trigger "Start Recording" command Raycast->>Extension: Execute start-recording.tsx Extension->>System: system_profiler SPDisplaysDataType System-->>Extension: Display name Extension->>Extension: Construct JSON action object Extension->>Extension: Encode as URL parameter Extension->>Cap: Open deeplink cap://action?value={encoded_json} Cap->>Rust: Parse deeplink URL Rust->>Rust: Deserialize JSON to DeepLinkAction enum Rust->>Rust: Match StartRecording variant Rust->>Rust: Call set_camera_input(app, state, camera) Rust->>Rust: Call set_mic_input(state, mic_label) Rust->>Recording: start_recording(app, state, inputs) Recording-->>Rust: Recording started Rust-->>Cap: Success Cap-->>Extension: Deeplink handled Extension->>Raycast: showHUD("Started recording") Raycast->>User: Display HUD notification User->>Raycast: Trigger "Switch Camera" command Raycast->>Extension: Execute switch-camera.tsx Extension->>System: system_profiler SPCameraDataType System-->>Extension: Camera list Extension->>Raycast: Display camera selection list User->>Raycast: Select camera Raycast->>Extension: User selected camera Extension->>Extension: Construct switch_camera action Extension->>Cap: Open deeplink cap://action?value={encoded_json} Cap->>Rust: Parse deeplink URL Rust->>Rust: Match SwitchCamera variant Rust->>Rust: Call set_camera_input(app, state, Some(camera)) Rust-->>Cap: Camera switched Extension->>Raycast: showHUD("Switched to camera") Raycast->>User: Display HUD notification(4/5) You can add custom instructions or style guidelines for the agent here!
Context used:
dashboard- CLAUDE.md (source)dashboard- AGENTS.md (source)