WOLBΛRG

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 init

A 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 --yes

Packages:

PackagePurpose
@wolbarg/workspaceCLI + domain library
@wolbarg/workspace-mcpMCP 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 codex

Restart 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-text

The 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:

FileWhat it is
.wolbarg/workspace/config.jsonStorage + embedding settings
.wolbarg/workspace/memory.dbLocal SQLite database (default)
.env.wolbargAPI 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 review

How it relates to the SDK

LayerPackageJob
SDKwolbargEmbeddings, storage, search, providers
Product@wolbarg/workspaceProject 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.