is-agentic
v1.0.1
Published
Score agent readiness with readable terminal reports and structured JSON.
Downloads
3,657
Maintainers
Readme
▲ / Is Agentic
Measure how ready a public website is for AI agents—directly from the terminal. The CLI retrieves the latest completed Is Agentic report and turns its audit evidence into a readable score and prioritized fixes.
No API key is required. Existing reports return immediately; when no completed report exists, the CLI starts a scan and waits for the canonical result.
Run it
No installation or API key required:
npx is-agentic vercel.com▲ / Is Agentic vercel.com
████████████████████████████████░░░░ 90 / 100
Strong technical baseline
4 failed · 7 partial
SCORE BREAKDOWN
Essential 68.9 / 80 10 / 12 passed
Recommended 15.7 / 20 16 / 25 passed
Bonus +5 36 positive signals
FAILURES (4)
1. FAIL · ESSENTIAL Agent-friendly 404s
Evidence Nonexistent paths return HTTP 200 with the app shell.
Fix Return a real HTTP 404 or 410 for nonexistent paths.The full report separates failures from partial checks and wraps each finding into labeled Evidence and Fix fields.
JSON for agents and scripts
Add --json or -j:
npx is-agentic vercel.com --jsonSuccessful output is the public API response unchanged:
npx is-agentic vercel.com --json | jq '.score'API failures and local CLI errors are also emitted as structured JSON on stdout. Errors use a nonzero exit status, so automation never needs to parse human-facing text.
Command reference
| Command | Output |
| --- | --- |
| npx is-agentic <domain-or-url> | Human-readable terminal report |
| npx is-agentic <domain-or-url> --json | Structured JSON |
| npx is-agentic --help | Usage and available options |
Set NO_COLOR=1 to disable ANSI color. Node.js 18 or newer is required.
How report lookup works
- The CLI requests the latest completed stored report first.
- If no report exists, it starts one scan and follows its progress to storage.
- It never forces a rescan when a completed report is already available.
- Scans only observe the target's public website; they do not mutate it.
- Success exits with
0; usage, API, and network errors exit nonzero.
