By tyroneross
Capture screenshots, videos, and polished demo clips — spotlight focus, lower-third captions, and a tagged library — across web, macOS, and iOS
Quick screenshot or video of current session
Start a Spectra automation session
Manage the spectra capture library — tag, find, gallery, export, status, delete, migrate from showcase
Record a side-by-side composite video from two app windows
List and manage Spectra sessions
Use when the user asks to capture screenshots, record a demo or video, create marketing assets, or document a feature visually from a running application.
Use when the user asks to produce a polished demo video from a screen recording, highlight key moments in a recording, add spotlight focus to video segments, create an agent demo video, or trim and caption a screen capture for sharing.
Use when the user asks to walk me through a UI, demo this flow, show me how a feature works, capture a walkthrough, or navigate a web/macOS app with Spectra.
Use when planning or producing product marketing content/video for any software product — "plan a marketing video", "app store preview", "product hunt launch", "explainer vs demo", "LinkedIn/YouTube video for <product>", "launch video", "what video should I make for <app>", "ongoing content plan", "changelog/release video", "readme demo GIF", "repurpose this into shorts", or when Spectra is about to capture/produce marketing assets and should tailor them to the product's audience, channel, and funnel stage. Turns product × audience × goal into a concrete plan (video type, length, channel, story-spine script, specs, polish style) and routes production to Spectra's capture/record/polish tools.
Use when a video's craft needs tuning — "this video looks/feels off", "how should this video be paced", "what color/typography/font size for video", "music or voiceover pace", "cut rate", "why isn't my video engaging", "make it feel premium" or "make it feel authentic", "kinetic text", "safe zones", or when Spectra is polishing/rendering a clip and needs concrete design settings (color, type, sound, pacing). Turns the emotional/visual/sound/pacing science into font-size floors, cut-rate targets, color rules, and Spectra polish parameters.
Admin access level
Server config contains admin-level keywords
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Executables (bin/) — files in this plugin's bin/directory are added to the Bash tool's PATH while the plugin is enabled.
Content capture for marketing — screenshots, videos, and app usage sequences for blog posts, social media, and documentation.
Works across web (Chrome DevTools Protocol), macOS (accessibility bridge), iOS and watchOS (simulators).
/plugin marketplace add tyroneross/spectra
/plugin install spectra@spectra
Requirements: Node.js 22+, macOS (for native features), Xcode CLI tools (for Swift compilation)
git clone https://github.com/tyroneross/spectra.git
cd spectra
npm install
npm run build
# Compile the Swift binary to ~/.spectra/bin/spectra-native
npm run build:native
# Optional: compile the SwiftUI test fixture
npm run build:test-app
macOS permissions required:
cd web-ui
npm install
cd ..
npm run serve # → http://localhost:4300
Spectra is a Claude Code plugin. Install via the marketplace (see above) or locally for development:
# From another project, point Claude Code at the Spectra directory
claude --plugin-dir /path/to/spectra
Or add to .claude/settings.json:
{
"plugins": ["/path/to/spectra"]
}
| Command | Purpose |
|---|---|
/spectra:connect <target> | Start a capture session |
/spectra:walk <description> | Walk through a flow with natural language |
/spectra:capture | Screenshot current state |
/spectra:sessions | List active sessions |
The primary Spectra path is host-routed. A host agent such as Claude Code,
Codex, or another LLM coding host reads spectra_snapshot, plans the next
action, and calls Spectra MCP tools to execute and capture. Spectra does not
need a model API key for this path.
The standalone Spectra.app fallback is for sessions launched outside a host
agent. In that case the app uses WalkthroughPlanner.swift and
AnthropicClient.swift to plan locally, with the user's key stored in Keychain.
Use host-routed walkthroughs when working inside a coding agent. Use the standalone path when the menu-bar app is the only planner available.
spectra_connectStart a new UI automation session.
| Param | Type | Required | Description |
|---|---|---|---|
target | string | yes | URL, app name, or sim:device identifier |
name | string | Human-readable session name | |
record | boolean | Start video recording immediately |
Examples:
target: "https://myapp.vercel.app" → web (CDP)
target: "Finder" → macOS native (AX)
target: "sim:iPhone 16 Pro" → iOS simulator
target: "sim:Apple Watch Series 10" → watchOS simulator
Returns: { sessionId, platform, target, name }
spectra_snapshotGet the current accessibility tree snapshot.
| Param | Type | Required | Description |
|---|---|---|---|
sessionId | string | yes | Active session ID |
screenshot | boolean | Include base64 screenshot |
Returns: Serialized AX tree — compact element list with roles, labels, bounds, actions.
spectra_actPerform an action on a specific element.
| Param | Type | Required | Description |
|---|---|---|---|
sessionId | string | yes | Active session ID |
elementId | string | yes | Element ID from snapshot (e.g., "e4") |
action | enum | yes | click, type, clear, select, scroll, hover, focus |
value | string | Text to type or scroll amount in px |
Returns: { success, snapshot } — updated snapshot after the action.
spectra_stepNatural language navigation — describe what to do, Spectra finds the element and executes.
| Param | Type | Required | Description |
|---|---|---|---|
sessionId | string | yes | Active session ID |
intent | string | yes | What to do, e.g., "click the Log In button" |
Returns: { resolved, elementId, action, confidence, snapshot } — plus optional screenshot.
Uses the Jaro-Winkler resolution engine to fuzzy-match intents to AX tree elements.
spectra_captureTake a screenshot or manage video recording. Supports intelligent framing modes.
npx claudepluginhub tyroneross/rosslabs-ai-toolkit --plugin spectraBarbara Minto's Pyramid Principle for short-form, long-form, presentations, and audits
Coding Debugger for coding agents with debugging memory, verdict-based retrieval, pattern extraction, root-cause workflows, and parallel domain assessment.
Multi-phase build orchestration with native debugging: assess, plan, execute, review, iterate. Plan-verify gate on Phase 2. Optional UI design gates. Native debug-loop, debugging-memory, and logging-tracer skills provide root-cause investigation without a bundled MCP server. Orchestrator owns when-to-fire; bundled skills own procedural detail; the logging-tracer skill includes an optional Coding Debugger escalation hop to the standalone supporting plugin for extended capability.
End-to-end design tool for AI coding agents — guided UI builds, web/iOS/macOS guidance, visual checks, mockup matching, interaction testing, native scanning, native layout-fill / gap analysis
[Deprecated — use spectra] Dev asset capture for blog and website content
Unified capability management center for Skills, Agents, and Commands.
Ultra-compressed communication mode. Cuts 65% of output tokens (measured) while keeping full technical accuracy by speaking like a caveman.
Comprehensive UI/UX design plugin for mobile (iOS, Android, React Native) and web applications with design systems, accessibility, and modern patterns
Standalone image generation plugin using Nano Banana MCP server. Generates and edits images, icons, diagrams, patterns, and visual assets via Gemini image models. No Gemini CLI dependency required.
Multi-model consensus engine integrating OpenAI Codex CLI, Gemini CLI, and Claude CLI for collaborative code review and problem-solving.
Memory compression system for Claude Code - persist context across sessions