Architecture of goniszewski/grimoire
goniszewski/grimoire is 542 source files holding 2,232 symbols across 6 modules, written mainly in TypeScript, JavaScript, Shell. The largest module is tasks, with 143 files, and 67 files are entry points into the dependency graph.
How grimoire fits together
Input enters through the React frontend under src/, the HTTP API, the MCP endpoint, the import flow or the browser bookmarklet. The daemon under daemon/ is built on Bun, Hono and SQLite and listens on 127.0.0.1:3210 by default. Its entry points include daemon/src/index.ts, daemon/src/server.ts and daemon/src/mcp/server.ts. The REST contract is defined in daemon/src/api/contract.ts, and daemon/src/routes/backup.ts holds the backup routes. Each saved URL is queued, fetched, turned into readable text and indexed, with optional AI enrichment and embeddings applied afterwards.
Largest modules
- tasks: 143 files and 6,498 lines of code
- daemon: 142 files and 30,790 lines of code
- src: 136 files and 22,732 lines of code
- docs: 77 files and 34,937 lines of code
- root: 23 files and 5,037 lines of code
- scripts: 18 files and 5,181 lines of code
- .github: 1 file and 27 lines of code
- .hallmark: 1 file and 12 lines of code
Languages
By file count: TypeScript 277 files, JavaScript 4 files, Shell 4 files, Dockerfile 1 file, Ruby 1 file.
Documentation
Repowise documents grimoire in 364 pages generated from the source.
More on grimoire: summary and FAQ, codebase overview, code health.
Related guide: Best dependency graph tools for monorepos