How simoneriggi92/breakthewall works
Break the Wall is a desktop app for turning text or Markdown into a source-grounded structure that readers can explore. The main loop is to provide a source, have a model generate and validate an exploration, then inspect its parts, links, and citations alongside the source. The README also documents disassemblies, prepared examples, local and ChatGPT providers, and Claude integrations. The graph combines documented capabilities with source-index relationships; unsampled UI and storage internals are represented conservatively.
Main entry points: generator.ts Generation coordinator · App.tsx App shell · disassembly-generation.ts Disassembly generation · server.ts MCP server
Components 21
Source and generation
- Studio input
src/renderer/Studio.tsx - Source handling
src/core/source.ts - Generation coordinator
src/desktop/generator.ts
Structure and validation
- Exploration generation
src/core/exploration-generation.ts - Exploration model
src/core/exploration.ts - Lesson model
src/core/lesson.ts - Disassembly generation
src/core/disassembly-generation.ts - Disassembly model
src/core/disassembly.ts - Disassembly layout
src/core/layout.ts - Provider contracts
src/core/provider.ts
Desktop experience
- App shell
src/renderer/App.tsx - Exploration view
src/renderer/exploration/ExplorationView.tsx - Exploration library
src/renderer/Library.tsx - Desktop runtime
src/desktop/main.ts - Progress storage
src/desktop/progress-store.ts
Providers and assistants
- ChatGPT account
src/desktop/chatgpt/account.ts - Local runtimes
src/desktop/local/runtimes.ts - MCP server
src/mcp/server.ts - Claude assistant tools
src/mcp/assistant.ts
Other components
- Reader
- Claude user
Connections 22
- Reader → Studio input: provides source
- Studio input → Generation coordinator: requests exploration
- Generation coordinator → Source handling: verifies selection
src/desktop/generator.ts - Generation coordinator → Exploration generation: generates structure
src/desktop/generator.ts - Exploration generation → Exploration model: validates result
src/core/exploration-generation.ts - Exploration generation → Lesson model: uses lesson types
src/core/exploration-generation.ts - Generation coordinator → Provider contracts: uses provider API
src/desktop/generator.ts - App shell → Exploration view: opens exploration
src/renderer/App.tsx - App shell → Exploration library: loads library
src/renderer/App.tsx - Exploration view → Exploration model: renders structure
src/renderer/exploration/ExplorationView.tsx - App shell → Desktop runtime: uses desktop bridge
src/renderer/App.tsx - App shell → Progress storage: loads progress
src/renderer/App.tsx - Generation coordinator → Disassembly generation: generates disassembly
src/desktop/generator.ts - Disassembly generation → Disassembly model: assembles and checks
src/core/disassembly-generation.ts - Disassembly generation → Disassembly layout: computes layout
src/core/disassembly-generation.ts - Disassembly generation → Provider contracts: uses provider API
src/core/disassembly-generation.ts - ChatGPT account → Provider contracts: implements provider
src/desktop/chatgpt/account.ts - Local runtimes → Provider contracts: implements provider
src/desktop/local/runtimes.ts - Claude user → MCP server: requests exploration
- MCP server → Claude assistant tools: dispatches assistant tools
src/mcp/server.ts - MCP server → Exploration generation: generates exploration
src/mcp/server.ts - MCP server → Disassembly model: handles disassembly
src/mcp/server.ts