# goniszewski/grimoire

> grimoire is a local-first bookmark manager for people who save technical resources and need to find them later. It saves links, imports browser bookmarks, extracts readable content, and searches by keyword or meaning, with optional AI providers that can summarize and organize the library. Saved bookmarks are processed through a durable SQLite job queue and the data stays on the user's machine. Its main language is TypeScript.

Source: https://github.com/goniszewski/grimoire
Indexed: commit 5323001 on 2026-08-13 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: MCP server
- Language: TypeScript
- Stars: 2,891 at index time
- License: MIT
- Code health: 6.6/10, Fair
- Last commit: 2026-08-03
- Contributors: 1

## Install

From the README: https://github.com/goniszewski/grimoire#install-and-upgrade-paths

Clone the grimoire repository.
    git clone https://github.com/goniszewski/grimoire.git

Move into the grimoire folder.
    cd grimoire

Clone the repository and install the root dependencies with npm.
    npm install

Install the daemon dependencies with Bun from the daemon directory.
    cd daemon && bun install

Start the daemon in its own terminal.
    npm run daemon:dev

Start the frontend in a separate terminal and open the Vite app.
    npm run dev

## How it works

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.

- daemon/src/cli.ts: entry point
- daemon/src/db/seed/dev-seed.ts: entry point
- daemon/src/index.ts: entry point
- daemon/src/mcp/server.ts: entry point
- daemon/src/server.ts: entry point
Modules: tasks, daemon, src, docs, root, scripts, .github, .hallmark. 542 files, 105,276 lines, 2,232 symbols.

## Code health

- Score: 6.6/10 (Fair)
- Rank: #177 of 4,000+ indexed repos
- Hotspots: src/pages/Settings.tsx, daemon/src/api/contract.ts, daemon/src/routes/backup.ts, src/lib/api.ts, src/hooks/use-bookmarks.ts
- Lowest file: daemon/src/settings.ts
- Dead code: 63 findings

## Maintenance

- Last commit 2026-08-03, first commit 2026-07-20, 186 commits
- 1 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/goniszewski/grimoire/security

## More

- Page: https://repowise.dev/repo/goniszewski/grimoire
- Ask this codebase: https://repowise.dev/repo/goniszewski/grimoire/chat
- Docs: https://repowise.dev/repo/goniszewski/grimoire/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/goniszewski/grimoire
