# Causari

> AI-written code has no author. It has causes. Causari proves them.
> Causari measures how many lines from AI-tagged commits are still alive in
> any git repository (counts, not grades), and records the causal provenance
> (prompt, model, reads, writes) behind every change an AI agent makes.
> Apache-2.0, local-first, no telemetry, verifiable offline.

Ways to use Causari without installing anything:
- Weekly measurements on open-source repositories: https://causari.dev/survival
  (unranked, method and limits at https://causari.dev/method)
- Add one CI step to any repo: `uses: croviatrust/causari@v1` posts the
  survival counts on every pull request.

Local install (single binary, about 5 MB, Linux/macOS/Windows):
- Linux/macOS: curl -fsSL https://causari.dev/install.sh | sh
- Windows: irm https://causari.dev/install.ps1 | iex

Key commands:
- `re audit [owner/repo]` — AI code survival from git history alone; `--json`
  gives the exact bytes; `--summary` gives Markdown for CI
- `re init` — create the local ledger `.causari/` (gitignored)
- `re hook claude-code` — record every Claude Code prompt and edit exactly
- `re proxy` — local LLM proxy recording prompts, models, tokens, cost
  (Aider and OpenAI/Anthropic-compatible clients); `--seal` issues
  crovia.seal.v1 receipts
- `re why <file>:<line>` — which recorded event produced this line
- `re trace <file>:<line>` / `re impact <event-id>` — upstream / downstream
  causal cone over recorded events
- `re bisect --test "<cmd>"` — first recorded event that breaks a test
- `re revert <id>` — restore the pre-state of an event, with a preview
- MCP server: `re mcp` (stdio) exposes causari_record, causari_recall,
  causari_why; `re mcp --install` prints the client config

What Causari does not claim: inline completions (Copilot, Cursor Tab) leave
no git trace and are invisible to `re audit`; the proxy join is a heuristic
and says so; a survival ratio is a count, not a quality judgement.

## Docs
- [README](https://github.com/croviatrust/causari#readme): full command reference
- [Method](https://causari.dev/method): detection rules, computation, limits, how to contest a number
- [Manifesto](https://github.com/croviatrust/causari/blob/main/MANIFESTO.md)
- [Roadmap](https://github.com/croviatrust/causari/blob/main/ROADMAP.md)
- [GitHub Action](https://github.com/marketplace/actions/causari-survival-audit)

## Family
- [Crovia Trust](https://croviatrust.com): TACET (verifiable silence proofs),
  PNX (proof of non-exfiltration), Crovia Seal (receipts for AI outputs)

## Source
- [Repository](https://github.com/croviatrust/causari) (Apache-2.0)