# Causari

> Causari is an open-source MCP server for developer tools. Count how many AI-tagged lines survive in a git repo and log agent prompts per edit. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://causari.dev
- **Repository:** https://github.com/croviatrust/causari
- **MCP Registry name:** io.github.croviatrust/causari
- **Categories:** developer tools, analytics and data
- **Listing updated:** 2026-11-15

## About

Causari answers a narrow question: of the lines introduced by commits whose git metadata matches an AI rule, how many does `git blame` still attribute to those commits at HEAD? The `re audit` command reads Co-Authored-By trailers, bot authors and agent markers, and reports a survival count next to a baseline of untagged lines in matched age windows. It works on any git repository, including a public one passed by name.

The tool is blunt about what it cannot see. Inline completions leave no git trace, commits without a trailer are unknown rather than human, and a metadata match does not prove a model wrote the line. A one-off bulk commit can dominate the ratio, so it also reports a capped ratio and a per-commit median.

The second half is a local ledger. Hooks for Claude Code and Cursor record each prompt, model and file touched into a gitignored `.causari/` folder, and `re why file:line` names the event linked to a line. This ledger is what the MCP server (`re mcp`) exposes. It is one Rust binary, Apache 2.0, with no account or telemetry.

## Features

- **Survival audit:** Counts AI-tagged lines still alive at HEAD using git blame.
- **Age-matched baseline:** Compares tagged lines to untagged lines in the same repository by age.
- **Agent edit ledger:** Records prompt, model and files for each agent edit in a local folder.
- **Line lookup:** re why names the ledger event associated with a line.
- **Signed seals:** Authenticate that a key signed a measurement for a commit and method.
- **Single binary:** One Rust binary with no cloud, account or telemetry.

## Good for

- Measure how much AI-assisted code from a repo is still alive
- Add a survival count to CI as Markdown
- Trace which prompt produced an edit
- Compare an agent's code survival against human commits

## Install

### Claude Code (Terminal)

```sh
claude mcp add causari -- npx -y causari
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "causari": {
      "command": "npx",
      "args": [
        "-y",
        "causari"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "causari": {
      "command": "npx",
      "args": [
        "-y",
        "causari"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "causari": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "causari"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "causari": {
      "command": "npx",
      "args": [
        "-y",
        "causari"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "causari": {
      "command": "npx",
      "args": [
        "-y",
        "causari"
      ]
    }
  }
}
```

## FAQ

### Does it prove who wrote a line?

No. AI-tagged means metadata matched; the ledger records what the runtime declared, not authorship.

### What does it miss?

Inline completions such as Copilot or Cursor Tab leave no git trace, and untagged commits count as unknown.

### What is the licence?

Apache 2.0.

### Does it need setup?

The audit runs with one command on any git repo; the ledger needs re init and a hook.

### Is Causari free?

Yes. Causari is open source, so you can use and self-host it for free.

### How do I add Causari to Claude Code?

Run this command in your terminal: claude mcp add causari -- npx -y causari

### What are the best alternatives to Causari?

The closest alternatives to Causari are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/causari
