Skip to content

Causalist

Causalist makes any codebase legible — to humans and to agents.

Core trick

Builds a file-level dependency graph from imports and calls, then exposes it to coding agents over MCP to replace blind file searching.

Tags

Description

Causalist makes any codebase legible — to humans and to agents. Drop in a GitHub URL and four Opus 4.7 agents (Structure, Dependency, Semantic, Oracle) draw your repo as a live causal graph in 30–60 seconds. Files become nodes, imports and calls become edges, every node is classified by what it actually does (UI, API, logic, data, infra). For a beginner staring at an unfamiliar repo, it replaces hours of clicking through folders with a single picture of how the thing fits together. For a senior dev, it's the mental model you'd build over a week, ready in under a minute. But the bigger unlock is for coding agents. Today every agent operates blind: open one file, edit it, run tests, watch them fail, grep, repeat — burning context on rediscovery. Causalist gives agents a causal substrate. Through11 CLI tools (blast_radius, find_path, get_neighbors, summarize_node…), an agent can ask "what does this change break?" before changing anything, follow real cause-and-effect chains across files, and load only the slice of the repo that actually matters — slashing token usage and stopping the trial-and-error loops that eat sessions alive. Tree-sitter AST verification marks every LLM-inferred edge as confirmed or unverified, so the graph the agent reasons over is auditable, not hallucinated. One layer, two audiences: humans get a map of their codebase, agents get a verification loop for cross-file reasoning. Both think more causally, both burn less context, both stop guessing.
daxaur/causalist★ 10 forksTypeScriptCreated Apr 22, 2026 · last push Jul 6, 2026

README excerpt

<div align="center">

<svg width="56" height="56" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" xmlns="http://www.w3.org/2000/svg">
  <path d="M18 5.2 A 8.5 8.5 0 1 0 18 18.8"/>
  <circle cx="18" cy="18.8" r="1.9" fill="currentColor" stroke="none"/>
  <circle cx="18" cy="5.2" r="1.9"/>
</svg>

# Causalist

**A causal graph layer for any codebase — for humans, and for the agents writing code on your behalf.**

[![CLI on npm](https://img.shields.io/npm/v/causalist-cli?label=causalist-cli&color=cb3837)](https://www.npmjs.com/package/causalist-cli)
[![MCP on npm](https://img.shields.io/npm/v/causalist-mcp?label=causalist-mcp&color=cb3837)](https://www.npmjs.com/package/causalist-mcp)
[![Built with Claude Code](https://img.shields.io/badge/Built%20with-Claude%20Code-D97757?logo=anthropic&logoColor=white)](https://claude.com/claude-code)
[![Claude Opus 4.7](https://img.shields.io/badge/Model-Opus%204.7-D97757?logo=anthropic&logoColor=white)](https://anthropic.com)
[![MIT](https://img.shields.io/badge/license-MIT-black)](LICENSE)

</div>

---

<p align="center">
  <img src="docs/images/hero-graph.png" alt="Causalist 3D causal graph viewer — karpathy/nanogpt mapped, NumPy node selected with summary in the inspector" width="100%">
</p>
<p align="center"><sub><i>Karpathy's nanoGPT mapped in ~40s. Magenta nodes are top-tier by fan-in. The right panel shows what each file does and what it depends on. NumPy is highlighted as an external d

Team