Skip to content
LogoLogo

Install Causal in your agent

One command

From the project you want your agent to remember:

npx causal init

The installer detects the harness you are in and wires Causal into it. You can name the target explicitly instead:

npx causal init --plugin claude-code
npx causal init --harness openclaw

Plugin harnesses use --plugin; agent runtimes use --harness. The per-harness values are on Harness setup.

Causal installs into the harness you already run: no MCP block to hand-edit, no API key to paste into a project file.

What npx causal init does

Five things:

  1. Detects your harness.
  2. Signs you in.
  3. Installs the Causal Agent Skills.
  4. Registers the MCP server.
  5. Adds an always-on rule to recall relevant experience before acting and capture meaningful outcomes afterward.

The last step is the one that matters at runtime. The rule fires inside the harness, so what the agent tried before arrives ahead of the decision instead of waiting on a tool call. See Recall and capture.

The first release targets Claude Code, Cursor, Codex, OpenClaw, and Hermes.

What the installer reports

Three lines per harness:

HarnessReported
Claude CodeMCP server registered · memory skill installed · always-on recall rule added
CursorMCP server registered · project rule installed · outcome capture wired
CodexMCP server registered · AGENTS.md hook written · session briefing enabled
OpenClawMCP server registered · write firewall active · per-writer signing enabled
HermesMCP server registered · recall hook armed · outcome telemetry wired

From there, Causal records what your agents do. Nothing else is required of you: the store fills as they work, and past attempts start coming back once there are some to serve.

What it costs to start

A personal workspace starts with 2,000 memories, no card and no deadline. Team workspaces start on a 14-day card-less Pro trial with 10,000 memories. Reads are never billed. The full meter is on the pricing page.

Other harnesses

Python and TypeScript SDKs cover anything outside those five.

npm install causal
pip install causal

Both are under the same pre-launch caveat as the installer: the package names appear on the site, but nothing is published yet.

The SDK surface — client construction, method names, example code — is not yet published. This page will carry it at launch. Until then, the install commands above are the whole of what is documented.