Communitygithub.com

ShotGlass

Nimm App- und Browser-Demos auf macOS mit ShotGlass auf. Verwende es für Anfragen wie „Film ein Demo“, „Nimm eine Vorführung auf“ oder „Zeig, wie diese App funktioniert“ mit ShotGlass, sowie zum Bearbeiten oder Exportieren eines vorhandenen ShotGlass-Projekts.

Was ist ShotGlass?

ShotGlass ist ein MCP-basiertes Tool für macOS, das es KI-Agenten ermöglicht, App- und Browser-Demos aufzuzeichnen, zu bearbeiten und zu exportieren. Es verwendet einen zweistufigen Aufnahmeprozess: `recording_prepare` bereitet die Aufnahme vor und liefert einen Screenshot sowie eine snapshotId, und `compose` übermittelt die gesamte Sequenz von Schritten, die dann automatisch gefilmt wird. Agenten können Aktionen wie Mausklicks, Tastatureingaben, Text und Controller-Befehle spezifizieren und dabei zwischen ref-basierten Hintergrundaktionen und echten Eingabeaufforderungen unterscheiden. ShotGlass unterstützt auch das Rendern von Videos (`output:{mode:"video"}`), automatische Stilisierung und Zooms (`naturalStyle:true`) sowie das Bearbeiten bestehender Projekte. Es ist wichtig, dass sowohl die App als auch der MCP-Server auf demselben Mac laufen und dass Berechtigungsdialoge nicht blind akzeptiert werden.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/jakemanger/shotglass-skills/tree/main/skills/shotglass

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht ShotGlass?

Filme über ShotGlass' verbundene MCP-Werkzeuge. Verwende die aktuellen Schemas des installierten Servers für Werkzeugnamen und -parameter.

Starte hier

Verwende für ein neues Demo zwei Aufrufe:

  1. recording_prepare({app:"Notizen", allowSystemDisplayPrompt:true}) — ersetze die angeforderte App. Lies den zurückgegebenen Screenshot, die Referenzen und die snapshotId.
  2. compose({snapshotId, beats}) — sende die gesamte Sequenz auf einmal. ShotGlass filmt sie, stellt die Fenster wieder her und öffnet das Projekt im Editor.

Baue Beats aus dem zurückgegebenen Zustand auf: {ref:"<zurückgegebene ref>"}, {type:"text"}, {key:"cmd+s"} oder {point:{x,y},action:"click"}. Ersetze Platzhalter durch tatsächliche zurückgegebene Werte. Screenshot-Punkte sind screenshot.origin + Bildkoordinaten. Verwende stabile Tastaturnavigation für Dialoge und füge expectedFiles hinzu, wenn die demonstrierte Aufgabe Dateien speichert.

Liefere das Gewünschte

  • Film ein Demo: Lasse Stil- und Ausgabeoptionen ungesetzt. Behalte die ursprüngliche Rahmung und den bearbeitbaren Cursor bei, öffne dann den Editor.
  • Film und rendere: Setze output:{mode:"video"} im selben compose-Aufruf. Melde den zurückgegebenen delivery.videoPath.
  • Automatische Stilisierung oder Zooms anwenden: Setze naturalStyle:true nur, wenn angefordert.
  • Vorhandene Aufnahme bearbeiten: Untersuche das beabsichtigte Projekt mit den Editor-Werkzeugen und wende dann die gewünschten Bearbeitungen an. Rendere nur, wenn darum gebeten wird.

Bevorzuge Refs für Hintergrundaktionen. Koordinierte Aktionen können echte Eingabe erfordern. Setze allowRealInput:true nur mit vorhandener Benutzerautorisierung; andernfalls lasse ShotGlass die Zustimmung anfordern. Wiederverwende eine ShotGlass-Instanz und sende geplante Aktionen gemeinsam, anstatt eine Host-Aktionsschleife oder einen anderen Rekorder zu verwenden.

Falls blockiert

Wenn Werkzeuge fehlen, lies Setup. Die App und der MCP-Server müssen auf dem Mac laufen, der gefilmt wird.

Wenn Berechtigungen, eine Warnung oder ein Abbruch die Aufnahme unterbrechen, bewahre das zurückgegebene Projekt auf und melde den spezifischen Blockierer. Versuche nicht blind erneut oder lehne eine Warnung ab, die Benutzerdaten ändert. Der zweistufige Pfad gilt für ein vorbereitetes, planbares Demo, nicht für die Anforderung, einen fehlgeschlagenen Take als abgeschlossen vorzutäuschen.

Verwandte Skills