@spool-lab/core

Local Session preparation engine used by the Spool desktop app and CLI.

This package reads provider Sessions, stores normalized metadata and messages in SQLite, groups Sessions by project, maintains private organization state, and provides local full-text retrieval. Preparation is separate from publishing; Hub transport and public visibility do not live in this package.

Usage

import { getDB, listRecentSessions, searchFragments, Syncer } from '@spool-lab/core'

const db = getDB()

const results = searchFragments(db, 'authentication middleware', { limit: 10 })
const sessions = listRecentSessions(db, 20)

const syncer = new Syncer(db)
syncer.syncAll()

Responsibilities

• provider Session loading for Claude Code, Codex CLI, Gemini CLI, OpenCode, and Pi
• project grouping across agent sources
• incremental file and database ingestion
• SQLite metadata and message storage
• FTS5 retrieval, including CJK-friendly indexes
• private pins and desktop state
• security-scan storage and maintenance helpers

Browser-safe canonical records, views, and composed Session diffs belong to @spool-lab/session-kit.

Native Dependency

This package depends on better-sqlite3. Repository tooling caches native addons by platform, architecture, and NODE_MODULE_VERSION, so Node and Electron builds can coexist. pnpm spool prepares a missing Node cache automatically; Desktop wrappers prepare the Electron cache before launch.

Manual recovery remains available:

pnpm run rebuild:native:node
pnpm run rebuild:native:electron

License

MIT

Trademark

Spool™ is a trademark of TypeSafe Limited. The MIT License covers the source code only and does not grant permission to use the Spool name or logo.