Audit Kit

Fast local website audits for freelancers and agencies. Run HTML, security, Lighthouse, and report-generation workflows from one small CLI.

Sponsor Audit Kit

╭──────────────────────── Audit Kit ────────────────────────╮
│ ak check        guided one-off website audit               │
│ ak check --save choose where the audit files should go     │
│ ak new          create a reusable client workspace          │
╰────────────────────────────────────────────────────────────╯

Install

npm install -g auditkit
# or
bun add -g auditkit

Requirements:

• Rust + cargo
• Node.js 24+
• Chrome, Chromium, Brave, Edge, or Helium for Lighthouse

Quick start

ak check

Audit Kit asks for the website, runs the check, then asks where to save the markdown files.

› Website URL (https://example.com) https://example.com
✓ Fetching website and reading HTML
› Save this check as markdown? (Y/n) y
› Save folder (./auditkit-example-com) ~/audits/example
✓ saved /Users/you/audits/example/automated-check.md

Save anywhere

ak check https://example.com --save ~/audits/example
ak security https://example.com --save ~/audits/example
ak lighthouse https://example.com --save ~/audits/example
ak inspect https://example.com --save ~/audits/example

Saved files use simple names:

~/audits/example/
├─ automated-check.md
├─ security-check.md
├─ lighthouse.md
└─ lighthouse.json

Full client workflow

ak new
ak inspect latest
ak report latest

That creates an audit workspace, runs every check, then writes:

audits/<date-client>/
├─ workspace.md
├─ findings.md
├─ final-report.md
├─ client-email.md
└─ raw/lighthouse.json

Commands

Command	Use
ak check	guided HTML/SEO basics check
ak check <url> --save <folder>	save check markdown to any folder
ak security <url> --save <folder>	save security header audit
ak lighthouse <url> --save <folder>	save Lighthouse markdown + JSON
ak inspect <url> --save <folder>	run and save every automated check
ak new	create a client audit workspace
ak inspect latest	run all checks for the newest workspace
ak report latest	create the final report and client email
ak list	list audit workspaces

Browser override

AUDITKIT_BROWSER_PATH="/path/to/browser" ak lighthouse https://example.com

Development

npm test
cargo test

Architecture notes live in docs/ARCHITECTURE.md.