How starautumn/astroknot works
AstroKnot is an Electron knowledge-management desktop app whose central workflow is to open a project, organize knowledge as connected nodes in a 2D mind map or 3D star map, edit node content, and persist project data. The README also documents an embedded IDE, browser capture, AI chat/agent, calendar, version graph, application library, and cloud sync; these are represented as distinct product capabilities. The graph follows documented structure and sampled call sites; unsampled subsystem wiring is intentionally left broad or omitted.
Main entry points: module0_AppState.js Workspace State · preload.js Preload Bridge · index.js Electron Main · AstroKnot.js AstroKnot App
Components 22
Knowledge Workspace
- Workspace State
modules/module0_AppState.js - 3D Star Map
modules/VisualComponents/index.js - Knowledge Links
modules/VisualComponents/LineManager.js - 2D Mind Map
modules/2DView/index.js
Node Content
- Node Editing
modules/module5_SelectAndEdit.js - Rich Text Editor
modules/richEditor/index.js - Calendar and Diary
modules/calendar/index.js
Embedded Tools
- Sandbox IDE
modules/AppLibrary/ide/index.js - Application Library
modules/AppLibrary/AppManager.js - Embedded Browser
modules/AppLibrary/browser/index.js - AI Chat Agent
modules/AIChat/index.js
Data and Sync
- Version Graph
modules/versionGraph/versionGraph.js - Project I/O
main/ipc-file/project-io.js - File Manager
main/ipc-file/file-manager.js - System Storage
modules/systemStorage.js - GitHub Sync
main/ipc-file/github.js
Desktop Runtime
- AstroKnot App
AstroKnot.js - Electron Main
main/index.js - Preload Bridge
preload.js
Other components
- User
- Local Data
- GitHub
Connections 26
- User → AstroKnot App: opens
- AstroKnot App → Workspace State: initializes
- Workspace State → 3D Star Map: renders nodes
- Workspace State → 2D Mind Map: renders nodes
- Workspace State → Knowledge Links: supplies graph
- User → Node Editing: edits node
- Node Editing → Rich Text Editor: opens editor
- User → Calendar and Diary: manages schedule
- User → Sandbox IDE: opens sandbox
- Application Library → Sandbox IDE: launches IDE
- User → Embedded Browser: browses pages
- Embedded Browser → Workspace State: captures pages
- User → AI Chat Agent: chats or agents
- Workspace State → Version Graph: snapshots changes
- AstroKnot App → Electron Main: IPC requests
- Electron Main → Preload Bridge: exposes bridge
- Preload Bridge → System Storage: storage calls
- Preload Bridge → Project I/O: project calls
- Preload Bridge → File Manager: file operations
- Preload Bridge → GitHub Sync: sync requests
- Project I/O → Local Data: reads and writes
- File Manager → Local Data: manages files
- System Storage → Electron Main: sync IPC
- Electron Main → Local Data: persists settings
- GitHub Sync → GitHub: uploads and downloads
- Application Library → Workspace State: inserts app node