Scrawl-style feedback capture with hold-Shift drawing and Apple transcription

Abierto
#3,152 2 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
35/100
Tipo de issue
Nueva funcionalidad
Claridad
Necesita aclaración
Estado de actividad
Activo
Stack tecnológico
macos, rust
Área
cli, desktop

Línea de trabajo

Start by reading crates/project/src/cursor.rs for cursor/modifier handling, apps/desktop-gpui/src/transcription.rs for existing Whisper/Parakeet transcription, and apps/cli/src/caps.rs for agent context commands. Check issues #2136 and #2059 for related drawing and frame export work. Done means Shift-draw while recording, macOS SpeechAnalyzer option, and a single CLI/MCP export of annotated context.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Feature

yo @richiemcilroy, can we make this a Cap feature? https://github.com/kitlangton/scrawl

The situation

I want to record a bug or UI change, talk through it, point at the exact thing, and hand the result to a coding agent. Scrawl packages the recording into timestamped screenshots, the matching narration, clicks and drawn marks. The agent gets the context without me typing it all out again.

This feels like a natural fit for Cap. I'd rather do it in the recorder I already use.

What works today, and why it is not enough

Cap already has a lot of the pieces:

I couldn't find the full Scrawl-style handoff, Apple speech backend, or live hold-Shift drawing in current main. Screenshot freehand drawing exists (#2136), but the ask here is drawing while recording.

https://github.com/user-attachments/assets/ceae6b30-09be-4e6d-b840-c788a9c6edbc

Ask

  • Hold Shift and move the pointer to draw on screen while recording. Release Shift to return to normal interaction. Keep those marks aligned with the recording and include them in exported frames/video. Ideally the modifier is configurable so it doesn't interfere with shortcuts in the app being recorded.
  • Offer Apple's on-device transcription on Mac. Scrawl already uses SpeechAnalyzer on macOS 26 and on-device SFSpeechRecognizer on macOS 15. Could Cap offer that alongside Whisper/Parakeet? It would need OS/language/model availability handling, but this seems worth supporting as a native option.
  • One action to copy/export context for an agent: selected screenshots or a contact sheet, timestamped narration, clicks and drawn marks, with a structured manifest and readable summary. Expose the same output through the CLI/MCP so an agent can inspect a specific moment. Let this work locally without requiring an upload.

Related: #2059 asks for native frame-at-timestamp export, which would help with this.

The main thing is the loop: record, talk, hold Shift to point something out, stop, send the context to the agent. Can we get that directly in Cap?

Lenguaje dominante
Rust
Estrellas
25k
Forks
2.4k
Merge medio
1 d 8 h
PR fusionados (30 d)
676

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de CapSoftware/Cap

Todos los issues de CapSoftware/Cap

Issues similares

Más issues de Rust

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.