Vericlaw

README

<p align="center">
  <img src="docs/assets/github-hero-brand.png" alt="VeriClaw GitHub hero" width="100%" />
</p>

<h1 align="center">VeriClaw 爪印</h1>

<p align="center">
  <a href="https://github.com/Sheygoodbai/vericlaw/releases/latest">
    <img alt="Latest release" src="https://img.shields.io/github/v/release/Sheygoodbai/vericlaw?display_name=release&label=latest%20release&color=0f766e" />
  </a>
  <a href="https://github.com/Sheygoodbai/vericlaw/stargazers">
    <img alt="GitHub stars" src="https://img.shields.io/github/stars/Sheygoodbai/vericlaw?color=0d1d1c" />
  </a>
  <a href="https://github.com/Sheygoodbai/vericlaw/network/members">
    <img alt="GitHub forks" src="https://img.shields.io/github/forks/Sheygoodbai/vericlaw?color=c2410c" />
  </a>
  <a href="https://sheygoodbai.github.io/vericlaw/">
    <img alt="Landing page" src="https://img.shields.io/badge/landing%20page-live-c2410c" />
  </a>
  <a href="https://clawhub.ai/plugins/vericlaw">
    <img alt="ClawHub companion plugin" src="https://img.shields.io/badge/ClawHub-companion%20plugin-0f766e" />
  </a>
  <a href="LICENSE">
    <img alt="MIT License" src="https://img.shields.io/badge/license-MIT-111827" />
  </a>
</p>

<p align="center">
  <strong>Apple-native AI agent correction</strong>
</p>

<p align="center">
  AI agent correction, LLM supervision, hallucination remediation, and role-drift diagnosis across macOS, iPhone, and OpenClaw companion surfaces.
</p>

<p align="center">
  Turn drift evidence into diagnosis, intervention, verification, and casebook learning.
</p>

<p align="center">
  <a href="https://sheygoodbai.github.io/vericlaw/"><strong>Landing page</strong></a>
  ·
  <a href="https://sheygoodbai.github.io/vericlaw/download/"><strong>Download page</strong></a>
  ·
  <a href="https://github.com/Sheygoodbai/vericlaw/releases/latest"><strong>Latest release</strong></a>
  ·
  <a href="https://clawhub.ai/plugins/vericlaw"><strong>ClawHub plugin</strong></a>
  ·
  <a href="https://sheygoodbai.github.io/vericlaw/mcp-status/"><strong>MCP status</strong></a>
  ·
  <a href="https://github.com/Sheygoodbai/vericlaw/archive/refs/heads/main.zip"><strong>Download source zip</strong></a>
  ·
  <a href="docs/launch/github-launch-kit.md"><strong>Launch kit</strong></a>
  ·
  <a href="docs/launch/market-differentiation.md"><strong>Market differentiation</strong></a>
  ·
  <a href="docs/design/first-use-ux-iteration.md"><strong>First-use UX</strong></a>
  ·
  <a href="SUPPORT.md"><strong>Support</strong></a>
</p>

> Redistribution is allowed with attribution. Keep [LICENSE](LICENSE), [NOTICE](NOTICE), and [ATTRIBUTION.md](ATTRIBUTION.md) with substantial copies, preserve clear source references, and follow [TRADEMARKS.md](TRADEMARKS.md) for brand use.

## Why it exists

When a bot hallucinates, overreaches, or stops honoring its professional role,
another observability panel is not enough. `VeriClaw 爪印` is designed to turn
that moment into a closed correction loop instead of a passive alert.

<table>
  <tr>
    <td width="33%">
      <strong>Evidence-first cases</strong><br />
      Capture what actually happened before context disappears.
    </td>
    <td width="33%">
      <strong>Professional-role drift</strong><br />
      Diagnose failures as broken occupational contracts when that helps teams intervene faster.
    </td>
    <td width="33%">
      <strong>Apple-native supervision</strong><br />
      Keep the correction workflow coherent across iPhone and macOS instead of borrowing a generic web console.
    </td>
  </tr>
</table>

## The correction loop

`evidence -> diagnosis -> prescription -> verification -> casebook`

VeriClaw is built for moments where teams need to answer three questions fast:
what went wrong, what should happen next, and whether the correction actually held.

## Download and share

- Visit the [landing page](https://sheygoodbai.github.io/vericlaw/) for the fastest product overview, screenshots, and share-ready positioning.
- Use the [download page](https://sheygoodbai.github.io/vericlaw/download/) for the most stable public entry to the current release asset, checksums, and source archive.
- Use the [ClawHub plugin page](https://clawhub.ai/plugins/vericlaw) if you want the OpenClaw companion entry; installing it also exposes the bundled `vericlaw` discovery skill in the Skills surface.
- Open the [latest release](https://github.com/Sheygoodbai/vericlaw/releases/latest) for the current public launch snapshot.
- Download the public source package as a [ZIP archive](https://github.com/Sheygoodbai/vericlaw/archive/refs/heads/main.zip) or clone the repository directly:

```bash
git clone https://github.com/Sheygoodbai/vericlaw.git
```

- Reuse the launch copy, screenshots, and legal redistribution pack when forwarding the project internally or externally.

Current public download posture is GitHub-first: source distribution, launch materials,
screenshots, and release notes are public now. The ClawHub surface is the
companion plugin + skill entry, while the macOS app bundle lives on the GitHub
release/download path.

## Distribution surfaces

- `Download app`: use the [download page](https://sheygoodbai.github.io/vericlaw/download/) or [latest release](https://github.com/Sheygoodbai/vericlaw/releases/latest) for the real macOS ZIP.
- `Install companion`: use the [ClawHub plugin page](https://clawhub.ai/plugins/vericlaw) for the OpenClaw-facing plugin shell and bundled `vericlaw` skill.
- `Clarify MCP status`: use the [MCP status page](https://sheygoodbai.github.io/vericlaw/mcp-status/) when a directory or review site needs the truthful answer to `VeriClaw MCP` queries.
- `Browse source`: use the [GitHub repository](https://github.com/Sheygoodbai/vericlaw) for code, launch assets, and release history.
- `Share correctly`: cite the project as `VeriClaw 爪印` and prefer the canonical landing page, download page, release page, or repository links above.

## MCP status

As of April 5, 2026, `VeriClaw 爪印` is **not** published as a standalone public
MCP server.

- If you run a directory, recommendation page, or review roundup, classify VeriClaw as an `Apple-native correction companion for OpenClaw`.
- Best-fit labels remain `AI agent correction`, `LLM supervision`, `hallucination remediation`, and `role-drift diagnosis`.
- Do not tag the product as `mcp-server`; use the [official MCP status page](https://sheygoodbai.github.io/vericlaw/mcp-status/) for citation-safe wording.

## Cite and forward VeriClaw

- Use GitHub's `Cite this repository` panel or [CITATION.cff](CITATION.cff) when referencing VeriClaw in posts, decks, reports, newsletters, or mirrors.
- Copy-paste summary: `VeriClaw 爪印 is an Apple-native AI agent correction app for evidence-first diagnosis, intervention, verification, and casebook learning.`
- Canonical links: [landing page](https://sheygoodbai.github.io/vericlaw/), [download page](https://sheygoodbai.github.io/vericlaw/download/), [latest release](https://github.com/Sheygoodbai/vericlaw/releases/latest), and [GitHub repository](https://github.com/Sheygoodbai/vericlaw).
- Reposts and redistributions are welcome with attribution and a direct source link back to VeriClaw.

## Product glimpse

<table>
  <tr>
    <td align="center">
      <img src="docs/assets/screenshots/01-connect-gateway.png" alt="Connect to a trusted gateway" width="220" /><br />
      <sub>Connect to a trusted gateway</sub>
    </td>
    <td align="center">
      <img src="docs/assets/screenshots/02-review-settings.png" alt="Review evidence and settings" width="220" /><br />
      <sub>Review evidence and settings</sub>
    </td>
    <td align="center">
      <img src="docs/assets/screenshots/03-role-aware-followup.png" alt="Keep role-aware follow-up within reach" width="220" /><br />
      <sub>Keep role-aware follow-up within reach</sub>
    </td>
    <td align="center">
      <img src="docs/assets/screenshots/04-context-dashboard.png" alt="Pull live context into the correction loop" width="220" /><br />
      <sub>Pull live context into the correction loop</sub>
    </td>
  </tr>
</table>

<p align="center">
  <sub>
    Current gallery shows the paired OpenClaw gateway flow because VeriClaw is a companion surface, not a separate runtime.
  </sub>
</p>

## Who should open this repository

- Teams evaluating `AI agent supervision`, `LLM correction`, and `hallucination remediation` workflows
- Builders looking for `role-drift diagnosis`, `evidence-first incident review`, and `verification loops`
- Operators who want an `Apple-native` companion surface around OpenClaw instead of a generic web-only dashboard
- Partners, press, or early users who need a shareable launch kit, screenshots, and redistribution guidance

## What makes it different

- `Companion, not clone`: OpenClaw remains the runtime and gateway substrate. VeriClaw adds the native supervision and correction layer.
- `Correction, not only monitoring`: the product is meant to recommend the next intervention, not just display drift after the fact.
- `Professional-role drift`: many failures are framed as role-contract breakdowns when that leads to better remediation.
- `Casebook learning`: every closed loop should leave behind reusable correction memory instead of another disconnected incident log.

## Search intent and positioning

Teams usually discover VeriClaw through concrete problems rather than category names.
This repository is intentionally written for searches around:

- `AI agent correction`
- `LLM supervision for production bots`
- `hallucination and fake-completion remediation`
- `role-drift diagnosis for assistants`
- `macOS-native OpenClaw companion`
- `VeriClaw plugin for OpenClaw`
- `VeriClaw skill`
- `VeriClaw MCP`
- `Is VeriClaw an MCP server`
- `evidence -> diagnosis -> intervention -> verification workflow`

## Support VeriClaw

- Star the [GitHub repository](https://github.com/Sheygoodbai/vericlaw) if the project is useful to you.
- Watch [new releases](https://gith

... (truncated)