# Show HN: Witnis – blast radius that follows inheritance where grep stops

> Source: <https://github.com/L00PLeGeNd/Witnis>
> Published: 2026-11-22 14:32:33+00:00

**Key takeaway:** Index the repo with `witnis index .` and run `witnis impact <symbol>` instead of grep to catch inheritance-linked callers such as `OwnerController` via `Owner extends Person`, and keep verify blocked until `WITNIS_ALLOW_VERIFY=1` plus `--execute` are set.

Local evidence for coding agents: index a repo, show blast radius, put the same envelope on a PR, and keep verify **blocked** until you authorize it.

Search name: **witnis-dev**. Not [Witnis AB](https://www.witnis.se). Apache-2.0. Listing: [mcprush](https://mcprush.com/l00plegend/witnis-witnis-dev-mcp).

```
pip install witnis
# or
uvx witnis
```

On [spring-petclinic](https://github.com/spring-projects/spring-petclinic) @ `500158f`, `git grep -lw Person -- '*.java'` hits five files. None of them are `OwnerController`, `PetController`, or `VisitController` — those only talk about `Owner`.

`witnis impact Person` follows `Owner extends Person` into those controllers.

```
witnis index .
witnis impact Person --plain
```

That is analysis completeness (grep vs index), not an LLM A/B test. Dual-human labels are still open. Notes: [`docs/benchmarks/petclinic-person-grep-vs-impact.md`](https://github.com/L00PLeGeNd/Witnis/blob/master/docs/benchmarks/petclinic-person-grep-vs-impact.md).

Use a full clone (`fetch-depth: 0`). `@v1` moves with 1.x; pin `@v1.11.2` if you do not want that. Default run is blocked — 0 commands executed.

```
- uses: actions/checkout@v4
  with: { fetch-depth: 0 }
- uses: L00PLeGeNd/Witnis/.github/actions/pr-gate@v1
```

Public tools: `index`, `look`, `impact`, `verify`. Everything else needs `WITNIS_MCP_EXPERIMENTAL=1`.

```
uvx witnis loop-init
```

That writes a Cursor / Claude snippet and a Harnis stdio policy. One install — seatbelt is not a second product. `WITNIS_DB` defaults to `.witnis/index.sqlite`.

```
{
  "mcpServers": {
    "witnis": {
      "command": "npx",
      "args": [
        "-y", "harnis", "mcp", "--preset", "coding-agent", "--",
        "uvx", "witnis", "mcp"
      ]
    }
  }
}
```

Verify does nothing until `WITNIS_ALLOW_VERIFY=1` and `--execute`. `automation_verified` means the allowlisted commands ran. It is not a human review.

More: [`SECURITY.md`](https://github.com/L00PLeGeNd/Witnis/blob/master/SECURITY.md) · [` docs/trusted-agent-loop.md`](https://github.com/L00PLeGeNd/Witnis/blob/master/docs/trusted-agent-loop.md) · [`docs/cli-cheatsheet.md`](https://github.com/L00PLeGeNd/Witnis/blob/master/docs/cli-cheatsheet.md) · PetClinic GT (not dual-human): [`docs/benchmarks/petclinic-human-v2.md`](https://github.com/L00PLeGeNd/Witnis/blob/master/docs/benchmarks/petclinic-human-v2.md).

mcp-name: io.github.L00PLeGeNd/witnis
