The core local-first product is implemented: save, extract, organize, search, review, back up, restore, and diagnose local issues. Source checkout and Docker are the currently supported run paths. A native installer, signed release archives, and a Homebrew formula are also implemented and undergoing live-installation validation before becoming supported install paths.
Shipped product areas:
- Bookmark ingestion, content extraction, PDF extraction, YouTube transcript extraction, and asynchronous pipeline status.
- SQLite storage with keyword search, semantic search, hybrid search, tags, category CRUD, and category drag-and-drop reparenting.
- Bookmark status actions: pin, archive, mark read, soft delete to Trash, restore from Trash, permanent delete, and 30-day trash purge.
- Personal notes, editable bookmark details, first-run empty state, daemon-offline banner, and degraded-mode messaging when AI or embeddings are not configured.
- AI enrichment, embedding generation, related bookmarks, organization agent suggestions, atomic suggestion acceptance, timeline events, and cold-start guard below 20 bookmarks.
- Settings page for AI, embeddings, runtime settings, app lock, backup destination, scheduled snapshots, and S3-compatible backup targets.
- Portable backup/restore snapshots with
manifest.json,checksums.sha256,snapshot.db, non-secretdata/settings.json, rollback directory creation, andrestart_required: truerestore responses. - Native install/upgrade/uninstall script for macOS LaunchAgent and Linux systemd user units.
- Docker deployment path with one loopback-bound container port (
127.0.0.1:3210:3210) serving both frontend and daemon API. - Streamable HTTP MCP endpoint at
/mcpfor bookmark search, reading, creation, and category listing. - Source-of-truth API contract in
daemon/src/api/contract.ts, generatedAPI.md, generateddocs/api-contract.json, and API docs drift checking. - Packaged
littleimpbackup CLI commands for create, list, restore, and local snapshot verification. - In-app local backup verification from Settings without restoring the snapshot.
- Optional encrypted backup packages through the
littleimpCLI and Settings. - Manual Settings, daemon API, and packaged
littleimp update checkpaths for GitHub Releases-compatible update availability checks. - Explicit packaged
littleimp update installnative upgrade flow with archive download, local archive support, checksum/signature verification, daemon restart, health version verification, and rollback guidance. - Signed release archive packaging for macOS and Linux with built frontend assets, daemon runtime files, checksums, and signature-ready manifests.
- One-command release installer that downloads the platform archive, verifies the published checksum, verifies detached signatures when present, and delegates to the native installer.
- In-repository Homebrew formula for an alternate MVP install path backed by checksum-verified release archives and
brew services. - Redacted diagnostics from Settings,
littleimp diagnostics, andGET /diagnosticsfor local support bundles without telemetry. - Local and CI quality gates for linting, type-checks, daemon tests, frontend tests, API docs drift checks, production build, Playwright E2E, and Docker health validation.
Grimoire 1.0 is a complete rewrite. The legacy Grimoire (SvelteKit + PocketBase) is
preserved on the legacy/v0.x
branch. A direct data-migration path is a high-priority post-1.0 item — no
automated tool ships yet.
- Supported source versions: Grimoire v0.4 or newer. Older releases are out of scope for the automated importer.
- The source data shape and field mapping from a PocketBase admin backup ZIP are already documented in docs/parity/grimoire-backup-import-shape.md.
- The importer will build on the existing browser/Netscape import pipeline and the JSON/CSV export parity fields (notes, read/archive/pinned state, read-later, opened metrics) already shipped for round-tripping.
- Until the tool lands, v0.4+ users can export from the legacy app and use the current import flows as an interim path.
Not yet implemented:
- Packaged browser extension or bookmarklet client for one-click saves, building on the protected local capture endpoint.
- Multi-device sync of live data.
- Multi-user or public-network deployment mode, tracked as post-MVP direction research in docs/multi-user-post-mvp-research.md.
- Optional authentication/rate limiting for non-local deployments.
- Direct legacy Grimoire backup import tooling (see Migration from Legacy Grimoire above).
- Plugin system.
- GitHub Issues extractor.
- Provider-specific consumer cloud APIs for Google Drive, Dropbox, OneDrive, or iCloud beyond normal synced folders.
- sqlite-vec-backed vector index optimization if the current float32 BLOB approach becomes a bottleneck.
| Journey | Status |
|---|---|
| Save a URL | Shipped |
| Search saved content by keyword | Shipped |
| Search saved content semantically or with hybrid ranking | Shipped |
| Add and edit personal notes | Shipped |
| Edit title, tags, category, and notes | Shipped |
| Pin important bookmarks | Shipped |
| Archive and unarchive bookmarks | Shipped |
| Move bookmarks to Trash, restore, and permanently delete | Shipped |
| Mark bookmarks as read or unread | Shipped |
| Create, rename, delete, and reparent categories | Shipped |
| Configure AI and embedding providers | Shipped |
| Understand degraded mode when AI or embeddings are unset | Shipped |
| Import browser bookmarks | Shipped |
| Export bookmarks to JSON or CSV | Shipped |
| Review and accept/reject AI suggestions | Shipped |
| Find related bookmarks | Shipped |
| Back up and restore local data | Shipped, with daemon restart required after restore |
| Verify local backups without restoring | Shipped |
| Create encrypted backup packages in Settings | Shipped |
| Verify or restore encrypted backup packages | Shipped from Settings for packages under the configured backup folder; shipped from CLI for arbitrary local paths |
| Run through Docker on localhost | Shipped |
| Connect through MCP on localhost | Shipped |
| Install without cloning the repository | Shipped through release archives and the one-command release installer |
| Install through Homebrew | Alternate MVP path implemented; full install validation is gated on publicly reachable release artifacts |
| Generate local diagnostics | Shipped |
| Migrate data from legacy Grimoire (v0.4+) | Planned (high priority) |
| Sync live data across devices | Future |
| Milestone | Status | Notes |
|---|---|---|
| M1 Core user journeys | Complete | Bookmark status actions, notes, Trash, archive, category CRUD, drag-and-drop reparenting. |
| M2 Settings UI | Complete | AI, embeddings, runtime settings, app lock, and backup configuration. |
| M3 AI features | Complete | Embeddings, semantic/hybrid search, related bookmarks, organization agent, review queue. |
| M4 Testing infrastructure | Complete | Daemon/unit integration tests, frontend tests, Playwright E2E, API contract drift checks, CI. |
| M5 Distribution readiness | Complete | Native installer, Docker path, first-run/degraded states, backup/restore, and diagnostics. |
| v1.0 hardening | Complete | Runtime settings, Docker safety, CI, safe backup/restore, API docs source of truth, shared API types, and documentation alignment. |
| # | Question | Decision |
|---|---|---|
| 1 | Archive vs delete UX | Archive is hidden permanently with no expiry and its own page. Trash is a separate 30-day soft-delete state with restore and permanent delete. |
| 2 | Notes rendering | Markdown read mode with textarea edit mode. |
| 3 | Pinned bookmark display | Pinned bookmarks sort first within the active view. |
| 4 | Settings surface | Dedicated /settings page. |
| 5 | Category move UI | Drag-and-drop reparenting is primary; "Move to..." remains the fallback/mobile path. |
| 6 | Test framework | Bun test runner for daemon; Vitest and Playwright for frontend. |
| 7 | Suggestion acceptance | Suggestion action, acceptance status, and timeline insert happen in one SQLite transaction. |
| 8 | Auto-apply behavior | Confidence >= 0.9 executes directly and records timeline; lower confidence queues for review. |
| 9 | Cold-start behavior | Under 20 bookmarks, organization automation is limited; keyword search still works and semantic search works where embeddings exist. |
| 10 | Vector storage | Embeddings are stored as float32 BLOBs in SQLite; sqlite-vec remains a future optimization. |
| 11 | Backup model | Backup is snapshot-based, not live sync. Restore recreates local state from a portable snapshot and requires daemon restart. |
| 12 | Cloud backup scope | S3-compatible storage is the first remote target. Cloud-synced folders are supported as local destinations. |
| 13 | Docker network model | Docker binds the host port to 127.0.0.1; container-internal HOST=0.0.0.0 only enables Docker forwarding. |
| 14 | API documentation | daemon/src/api/contract.ts is the source of truth; API.md and docs/api-contract.json are generated artifacts. |
| 15 | Scope | Grimoire 1.0 is local-first, single-user, and loopback-first. Multi-user/server mode, endpoint aliases, and packaged browser-extension clients are explicitly out of scope for 1.0. |