Wolbarg Workspace
Shared, reconciled project truth for Cursor, Claude Code, and Codex — install from npm with @wolbarg/workspace.
Wolbarg Workspace is the product built on top of the
wolbarg SDK. The SDK stays tool-agnostic; Workspace
adds project truth, reconciliation, and agent connectors.
Why use it?
Cursor, Claude Code, and Codex forget everything when a session ends. They re-investigate the same code, reopen settled decisions, and act on stale context.
Wolbarg Workspace keeps one shared, always-current view of your project — decisions, architecture, tasks, bugs, conventions — and every connected agent reads and updates it automatically.
- Stop re-explaining your codebase every session.
- A decision made in Cursor is known to Claude Code and Codex.
- Old facts get replaced, not piled up.
- Runs fully local by default.
Install
Published on npm as @wolbarg/workspace@0.1.0.
Run inside your project folder (not global):
npm install @wolbarg/workspace
npx @wolbarg/workspace initA short wizard asks for storage and an embedding provider. Press Enter to keep the defaults (SQLite + Ollama, fully local).
Skip the wizard:
npx @wolbarg/workspace init --yesPackages:
| Package | Purpose |
|---|---|
@wolbarg/workspace | CLI + domain library |
@wolbarg/workspace-mcp | MCP server (installed by connect) |
Source: github.com/wolbarg/workspace
Connect your agent
npx @wolbarg/workspace connect cursor
npx @wolbarg/workspace connect claude
npx @wolbarg/workspace connect codexRestart the agent afterwards. No manual MCP JSON editing is required.
Embedding provider
Workspace needs an embedding model to search memory. The default is Ollama:
ollama pull nomic-embed-textThe init wizard also offers OpenAI, Voyage AI, Gemini, LM Studio, OpenRouter, or any OpenAI-compatible endpoint. API keys go in .env.wolbarg — never commit that file.
Config
init writes:
| File | What it is |
|---|---|
.wolbarg/workspace/config.json | Storage + embedding settings |
.wolbarg/workspace/memory.db | Local SQLite database (default) |
.env.wolbarg | API keys — do not commit |
Defaults: SQLite storage, Ollama embeddings, 90-day retention. Teams can switch to Postgres in the wizard. Re-run init any time to change providers.
Check that it works
npx @wolbarg/workspace doctor
npx @wolbarg/workspace status
npx @wolbarg/workspace reviewHow it relates to the SDK
| Layer | Package | Job |
|---|---|---|
| SDK | wolbarg | Embeddings, storage, search, providers |
| Product | @wolbarg/workspace | Project truth, reconciliation, CLI, connectors |
Use the SDK when you are building your own agent memory. Use Workspace when you want Cursor / Claude Code / Codex to share current project truth out of the box.