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

Aberta
#3,152 2 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
4/5
Tempo estimado
3-5 dias
Facilidade para iniciantes
35/100
Tipo de issue
Funcionalidade
Clareza
Precisa de esclarecimento
Status de atividade
Ativa
Stack de tecnologia
macos, rust
Domínio
cli, desktop

Direção de pesquisa

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.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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?

Linguagem predominante
Rust
Estrelas
25k
Forks
2.4k
Merge médio
1d 8h
PRs com merge (30d)
676

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de CapSoftware/Cap

Todas as issues de CapSoftware/Cap

Issues semelhantes

Mais issues de Rust

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.