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.
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.
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.** [](https://www.npmjs.com/package/causalist-cli) [](https://www.npmjs.com/package/causalist-mcp) [](https://claude.com/claude-code) [](https://anthropic.com) [](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