How ryancardin15/cinderdeck works
Cinderdeck is a native macOS development control deck: users define workspaces containing long-running services, one-shot tasks, and workflows, then start and inspect them locally or through agent controls. The README also documents recordings correlated with workspace logs, GitHub pull-request tools, capture and editing, and local history. The tree supports mapping these capabilities to their feature areas, but most workspace orchestration internals are unsampled; their links below rely on README statements rather than inspected call sites.
Main entry points: StacksViewModel.swift Workspace state · ScreenCaptureManager.swift Screen capture · AppStatusBarController.swift Menu bar app · StacksTabView.swift Workspace UI
Components 19
App shell
- Menu bar app
Cinderdeck/App/AppStatusBarController.swift
Workspace operations
- Workspace UI
Cinderdeck/Features/Stacks/StacksTabView.swift - Workspace state
Cinderdeck/Features/Stacks/StacksViewModel.swift - Service console
Cinderdeck/Features/Stacks/StackConsoleViewModel.swift - Stack editor
Cinderdeck/Features/Stacks/Components/StackDefinitionEditor.swift
Agent and Git
- Agent controls
Cinderdeck/Services/UnifiedApp/AgentShellController.swift - MCP service
agent-runtime/apps/server/src/mcp/OrchestratorMcpService.ts - Pull requests
Cinderdeck/Features/PullRequests/PullRequestsViewModel.swift
Capture and media
- Screen recording
Cinderdeck/Features/Recording/RecordingCoordinator.swift - Recording logs
Cinderdeck/Services/Repro/ReproRecordingController.swift - Screen capture
Cinderdeck/Services/Capture/ScreenCaptureManager.swift - Quick access
Cinderdeck/Features/QuickAccess/QuickAccessManager.swift - Annotation
Cinderdeck/Features/Annotate/AnnotateManager.swift - Video editor
Cinderdeck/Features/VideoEditor/VideoEditorManager.swift
History and settings
- Capture history
Cinderdeck/Services/History/CaptureHistoryStore.swift - Preferences
Cinderdeck/Features/Preferences/PreferencesManager.swift - Cloud uploads
Cinderdeck/Services/Cloud/CloudManager.swift
Other components
- Developer
- Configured storage
Connections 20
- Developer → Menu bar app: opens controls
README.md - Menu bar app → Workspace UI: opens workspaces
README.md - Developer → Stack editor: defines stack
README.md - Workspace UI → Workspace state: manages
README.md - Workspace state → Service console: runs services
README.md - Developer → MCP service: requests agent controls
README.md - MCP service → Workspace state: controls workspaces
README.md - Agent controls → Workspace state: controls workspaces
README.md - Service console → Recording logs: supplies workspace logs
README.md - Screen recording → Recording logs: records alongside video
README.md - Developer → Screen recording: records screen
README.md - Developer → Pull requests: reviews changes
README.md - Developer → Screen capture: captures screen
README.md - Screen capture → Quick access: adds capture
README.md - Quick access → Annotation: opens editing
README.md - Developer → Video editor: edits video
README.md - Screen capture → Capture history: stores captures
README.md - Developer → Preferences: configures app
README.md - Developer → Cloud uploads: configures uploads
README.md - Cloud uploads → Configured storage: uploads optionally
README.md