knol-local

library0.4.10jsnpmunverified

A lightweight, fully local memory layer for AI assistants — Claude Desktop, Claude Code, Cursor, Codex, and ChatGPT. Stores memories in a SQLite database with FTS5 full-text search and BM25 ranking. Version 0.4.10, active development, released biweekly. No cloud, no accounts, no API keys. Key differentiators: zero external dependencies beyond better-sqlite3 and MCP SDK; six MCP tools for querying memories via natural language; HTTP REST API for tools that don't support MCP; CLI for management, backup, and restore.

ai-ml

npm install knol-local

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · KNOL-LOCAL

knol-local

ai-mljavascriptv0.4.10

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

knol-local (CLI)

✓ knol-local add "content"

✗ npx knol-local add content

Install globally via npm install -g knol-local, then use directly from terminal

MCP Server

✓ knol-local --mcp

✗ node knol-local.mcp.js

MCP server is started by default when no command is provided; --mcp flag is optional

HTTP Server

✓ knol-local serve --port 3001

✗ knol-local start --port 3001

Use 'serve' command for REST API; default port is 3001, can be changed

setup

✓ knol-local setup claude

Accepts claude, cursor, or codex as argument; prints config instructions

export/import

✓ knol-local export --out backup.json

✗ knol-local backup (backup creates DB copy, not JSON export)

export creates JSON file, backup creates DB copy in timestamped directory

Install knol-local globally, add a memory with tags and importance, search, list, start HTTP server, and launch MCP server for Claude/Cursor integration.

npm install -g knol-local # Add a memory knol-local add "I prefer TypeScript strict mode" --tag preference --importance 0.9 # Search memories knol-local search "TypeScript" # List all memories knol-local list # Start HTTP server for Codex knol-local serve --port 3001 --key mysecret # Start MCP server (default) knol-local

Debug

Known issues

breakingNode.js >=18.0.0 required

fix

Upgrade Node.js to version 18 or later

affects: <18.0.0

gotchaMCP server expects `knol-local` on PATH; if installed locally via `npm install knol-local` without -g, you need to use npx

fix

Use `npx knol-local` or install globally with `npm install -g knol-local`

affects: >=0.1.0

gotchaHTTP API key is sent as Bearer token in Authorization header; if omitted, no authentication is required

fix

Ensure you pass `--key <token>` if you want auth, or omit for open access

affects: >=0.1.0

deprecatedBackup command creates DB copy; export command creates JSON — don't confuse backup with export for data portability

fix

Use `knol-local export --out file.json` for JSON export, `knol-local backup` for DB copy

affects: >=0.1.0

gotchaSearch uses FTS5 with Porter stemming; query terms may match unexpected variants

fix

Use exact phrases in quotes to bypass stemming if needed

affects: >=0.1.0

Errors

Common errors & fixes

Error: Cannot find module 'better-sqlite3'

better-sqlite3 native module not compiled for current platform/Node version

fix

Run `npm rebuild better-sqlite3` in the knol-local installation directory, or reinstall with `npm install -g knol-local`

Error: knex: Required configuration option 'client' is missing

Older version of knol-local may have used knex; current version uses better-sqlite3 directly

fix

Upgrade to latest knol-local: `npm install -g knol-local@latest`, then check if knex is listed in dependencies

knol-local: command not found

Package not installed globally or not on PATH

fix

Install globally: `npm install -g knol-local`. If still not found, check npm global bin directory is in PATH

Error: listen EADDRINUSE :::3001

Port 3001 already in use by another process

fix

Use a different port: `knol-local serve --port 3002`, or kill the process using port 3001

Upgrade

Version history

0.4.10latest on npm

Audit

Dependencies

better-sqlite3requiredSQLite database engine with FTS5 and BM25 support for local memory storage

@modelcontextprotocol/sdkrequiredModel Context Protocol server implementation for Claude/Cursor integration

Agent activity

7 hits · last 30 days

node

Resources

githubhttps://github.com/aiknol/knol-local ↗

packageknol-local ↗

homepagehttps://github.com/aiknol/knol-local#readme ↗