https://github.com/xiaojiou176-open/webaudit
Evidence-first browser automation for AI agents and operators, with recovery and MCP.
https://github.com/xiaojiou176-open/webaudit
ai-agents browser-automation codex coding-agents developer-tools e2e-testing fastapi mcp model-context-protocol openapi playwright reproducibility workflow-automation
Last synced: 6 days ago
JSON representation
Evidence-first browser automation for AI agents and operators, with recovery and MCP.
- Host: GitHub
- URL: https://github.com/xiaojiou176-open/webaudit
- Owner: xiaojiou176-open
- License: mit
- Created: 2026-04-07T02:41:21.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-27T14:40:47.000Z (28 days ago)
- Last Synced: 2026-05-27T16:16:27.527Z (28 days ago)
- Topics: ai-agents, browser-automation, codex, coding-agents, developer-tools, e2e-testing, fastapi, mcp, model-context-protocol, openapi, playwright, reproducibility, workflow-automation
- Language: TypeScript
- Homepage: https://xiaojiou176-open.github.io/webaudit/
- Size: 2.64 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Citation: CITATION.cff
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Support: SUPPORT.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
webaudit
every claim ships with its receipt
What You Get •
Install •
How It Work •
Ecosystem
---
webaudit turns long, messy AI outputs into auditable workflows. Every step gets a hash, every claim gets a source, every replay matches byte-for-byte.
```
┌──────────────────────────────────────┐
│ LOCAL-FIRST ████████ 100% │
│ SOURCE-TRACEABLE ████████ 100% │
│ TYPING REQUIRED ░░░░░░░░ 0% │
│ VIBES ████████ ZERO │
│ FILLER│
└──────────────────────────────────────┘
```
> Evidence-first workbench. Trace, hash, replay, prove.
## What You Get
| Surface | What |
|---|---|
| `webaudit apps` | Workshop, quick-launch, task center. Authored output, traced. |
| `packages` | Shared evidence primitives — hashing, tracing, snapshotting. |
| `mcp skills` | Hand a flow to any agent. Get a flow plus the receipt. |
| `contracts` | Versioned proof schemas. Diffable. Replayable. |
| `e2e tests` | Cross-surface integration. The receipts run too. |
> [!IMPORTANT]
> Local-first by default. No silent telemetry. No cloud round-trip. Your data stays on your machine until you explicitly ship it somewhere.
## Install
```bash
git clone https://github.com/xiaojiou176-open/webaudit.git
cd webaudit
# follow the per-stack quickstart in INSTALL.md or docs/
```
Three commands. No `curl | sh`. No login. Read what you run.
Install break? Open your favorite agent and say *"Read AGENTS.md and bootstrap webaudit for me."* Agent fix own brain. Long version: [`docs/`](./docs/).
## How It Work
The repo is seven layers — exactly the seven commits in `git log`. New work goes in as small named PRs. No 50-file mystery commits.
| Layer | What |
|---|---|
| `chore: scaffold` | License, governance, hygiene gates, CI scaffolding. |
| `feat(core)` | The primary engine. The reason webaudit exists. |
| `feat(modules)` | Packages, adapters, services, plugins. The second floor. |
| `feat(contracts)` | Schemas, configs, public boundaries. Other code talks here. |
| `test:` | Receipts. Everything in this layer must run. |
| `feat(ops)` | Scripts, infra, CI helpers, build glue. |
| `docs:` | Public docs surface. The pretty face. |
`git log` reads like a building floor plan. Look once, know the whole shape.
## Ecosystem
webaudit lives in the **yard family**: seven yards. one philosophy: structured input, structured output, structured proof.
| Repo | What |
|---|---|
| [**switchyard**](https://github.com/xiaojiou176-open/switchyard) | model & agent runtime switch board |
| [**browserclickyard**](https://github.com/xiaojiou176-open/browserclickyard) | your AI clicks, your browser obeys |
| [**noteyard**](https://github.com/xiaojiou176-open/noteyard) | your Apple Notes never really die |
| [**dealyard**](https://github.com/xiaojiou176-open/dealyard) | let prices fight, you sit and watch |
| [**docyard**](https://github.com/xiaojiou176-open/docyard) | docs site in, markdown out, no scraping by hand |
| [**fileyard**](https://github.com/xiaojiou176-open/fileyard) | messy folders in, organized library out |
| [**webaudit**](https://github.com/xiaojiou176-open/webaudit) *(you here)* | every claim ships with its receipt |
Cross-family taste:
[**BeamMe**](https://github.com/xiaojiou176-open/BeamMe) ·
[**BrewMe**](https://github.com/xiaojiou176-open/BrewMe) ·
[**OpenVibeCoding**](https://github.com/xiaojiou176-open/OpenVibeCoding) ·
[**webaudit**](https://github.com/xiaojiou176-open/webaudit).
## Star This Repo
If webaudit saves you a click, an hour, or a headache — star costs zero. Fair trade. ⭐
[](https://star-history.com/#xiaojiou176-open/webaudit&Date)
## Also by Yifeng[Terry] Yu
- **[switchyard](https://github.com/xiaojiou176-open/switchyard)** — model & agent runtime switch board
- **[browserclickyard](https://github.com/xiaojiou176-open/browserclickyard)** — your AI clicks, your browser obeys
- **[BeamMe](https://github.com/xiaojiou176-open/BeamMe)** — beam your agent config to any planet
- **[BrewMe](https://github.com/xiaojiou176-open/BrewMe)** — wake up, news already brewed
- **[OpenVibeCoding](https://github.com/xiaojiou176-open/OpenVibeCoding)** — AI codes overnight, you ship in the morning
## License
MIT — small print, big freedom.