How wassermanproductions/scriptbreak works
ScriptBreak is an offline screenplay-breakdown desktop app, with a separate stdio MCP server for inspecting saved projects and generating exports. The main workflow is script import → breakdown and editable production planning → local project data → exports. README-documented capabilities are represented at the frontend path because its implementation was not sampled; MCP responsibilities and file reading are supported by the sampled server excerpt. The frontend’s detailed internal calls and persistence wiring were not shown, so those relationships are omitted or attributed only to explicit documentation.
Main entry points: index.html ScriptBreak app · scriptbreak-mcp.mjs MCP stdio server · main.rs Tauri wrapper
Components 21
Desktop breakdown
- ScriptBreak app
src/index.html - Script breakdown
src/index.html - Project library
src/index.html - Draft comparison
src/index.html - Element tagging
src/index.html - Production bibles
src/index.html - Look and style guide
src/index.html - Tauri wrapper
src-tauri/src/main.rs
Production planning
- Shot lists
src/index.html - Timeline
src/index.html - Schedule and DOOD
src/index.html
Exports and prompts
- Breakdown exports
src/index.html - Prompt packs
src/index.html
MCP access
- MCP stdio server
mcp/scriptbreak-mcp.mjs - Saved project file
- Project query tools
mcp/scriptbreak-mcp.mjs - MCP pack export
mcp/scriptbreak-mcp.mjs
Other components
- Filmmaker
- Screenplay file
- External LLM
- MCP client
Connections 20
- Filmmaker → ScriptBreak app: loads script
README.md - ScriptBreak app → Script breakdown: imports and breaks down
README.md - Script breakdown → Project library: seeds project
README.md - ScriptBreak app → Draft comparison: compares drafts
README.md - ScriptBreak app → Element tagging: edits tags
README.md - ScriptBreak app → Production bibles: edits seeded bibles
README.md - ScriptBreak app → Look and style guide: ingests style PDF
README.md - ScriptBreak app → Shot lists: edits shot lists
README.md - ScriptBreak app → Timeline: shows scenes
README.md - ScriptBreak app → Schedule and DOOD: plans shoot days
README.md - ScriptBreak app → Breakdown exports: exports breakdowns
README.md - ScriptBreak app → Prompt packs: generates prompt packs
README.md - Filmmaker → MCP client: requests project data
- MCP client → MCP stdio server: sends tool calls
mcp/scriptbreak-mcp.mjs - MCP stdio server → Saved project file: reads JSON
mcp/scriptbreak-mcp.mjs - MCP stdio server → Project query tools: dispatches tools
mcp/scriptbreak-mcp.mjs - MCP stdio server → MCP pack export: dispatches generators
mcp/scriptbreak-mcp.mjs - MCP pack export → MCP client: returns Markdown
mcp/scriptbreak-mcp.mjs - Prompt packs → External LLM: pasted into
README.md - ScriptBreak app → Tauri wrapper: runs in desktop wrapper
README.md