FAQ
Frequently asked questions about Wolbarg installation, providers, storage, and retrieval.
What is Wolbarg Workspace?
@wolbarg/workspace is the product layer for coding agents (Cursor, Claude Code, Codex). It keeps shared, reconciled project truth on top of the wolbarg SDK. See Wolbarg Workspace.
What is Wolbarg?
A TypeScript SDK for shared semantic memory across AI agents. It is not an agent framework and not a hosted vector database. Start with the Quick Start, then read Concepts.
What Node version do I need?
Node.js 22.5+ because SQLite uses built-in node:sqlite.
Why does hybrid search throw ValidationError?
You likely set hybrid: true without keywordSearch: bm25(). Since 0.6.0, hybrid is fail-closed — there is no silent semantic-only fallback. See Hybrid Search.
Do I need an LLM to use Wolbarg?
No. LLM is required only for compress() (and for experimental rememberFromMessages({ mode: "extract" })). Remember/recall need storage + embedding.
Why does PDF ingest fail?
Install pdf-parse@1.1.4 in your app. Scan-only PDFs without a text layer need OCR/vision on images. See Document Ingestion and Limitations.
Can I use PostgreSQL?
Yes — npm install pg then storage: postgres({ connectionString }). Remote hosts default to sslmode=require. Optional schema namespacing and default maxPoolSize: 20. See PostgreSQL Backend and Production.
Where did graph memory go?
Removed in 0.6.0. Use metadata or an external store. See Graph memory (removed) and Migration.
How do multiple agents share memory?
One Wolbarg instance, different agent ids on remember/recall filters. See Multi-Agent Memory.
Where is the full docs dump for AI tools?
- /llms.txt — curated index
- /llms-full.txt — full Markdown export
- Append
.mdto any docs URL for that page as Markdown