Connect Claude Code

Two commands.

Mint an API key, paste two lines into your terminal. Claude Code can then create projects on your account and query your graphs — without re-grepping the repo.

Let Claude Code use your graphs

Causalist turns any GitHub repo into a typed causal graph — the kind agents can reason over instead of grepping. Connect Claude Code to your account once and it can map new repos, trace blast radius, and answer questions about your codebase from any terminal.

Sign in with GitHub first. Your API keys are tied to your GitHub identity, so projects an agent creates show up under your account.

What the snippet does

1
Install the CLI
```
$ npm install -g causalist-cli
```
Ships eleven graph-query subcommands + an optional Skill that teaches Claude Code when to use them.
2
Save your API key
```
$ causalist login --api-key cspl_live_…
```
Writes ~/.causalist/session.json. The MCP server and every CLI command pick it up automatically.
3
Optional — drop the Skill
```
$ causalist install
```
Adds SKILL.md to ~/.claude/skills/causalist/. Claude Code auto-discovers it; the model learns when to reach for `causalist blast`, `causalist tests`, etc.

What Claude Code can do once connected

causalist project create <repo>map a new repo on your account

causalist blast <id>what depends on this node

causalist tests <ids…>3 tests not 300

causalist path <a> <b>shortest causal path

causalist writers <id>who writes to this state

causalist verify <a> <b>is this edge real?

causalist similar <id>structurally similar nodes

causalist topo <ids…>topological build order

causalist layer <name>nodes in a layer

causalist node <id>single-node metadata

causalist neighbors <id>direct in/out edges

Advanced — live browser-tab streaming

Optional. Only needed if you want Claude Code’s tool-use events to stream live into a browser tab as it works.

▾

Generate a 6-char code at /pair, then run causalist pair <code> on your machine. The browser tab will flip to paired and start receiving live events.

You don’t need this for normal project creation or graph queries — those run on the API key alone.

New to Claude Code? docs.claude.com/claude-code·Manage keys in settings

What the snippet does

Install the CLI

$ npm install -g causalist-cli

Ships eleven graph-query subcommands + an optional Skill that teaches Claude Code when to use them.

Save your API key

$ causalist login --api-key cspl_live_…

Writes ~/.causalist/session.json. The MCP server and every CLI command pick it up automatically.

Optional — drop the Skill

$ causalist install

Adds SKILL.md to ~/.claude/skills/causalist/. Claude Code auto-discovers it; the model learns when to reach for `causalist blast`, `causalist tests`, etc.