Agent Permissions Playground

A small Next.js app for drafting, testing, and explaining agent-permissions.json files. You can try it live at https://agent-permissions-tools.vercel.app/.

Features

• Quick Builder: Toggle common rules (navigation, forms, downloads, rate limits) and copy a ready-to-ship JSON.
• Generator: Fetch a single landing page, stream intermediate logs, and get an LLM-generated draft policy. Shows any existing .well-known/agent-permissions.json.
• Parser / Explainer: Paste a policy to see human-friendly summaries of verbs, selectors, and directives.
• Themes: Light/dark toggle (defaults to system).

Getting Started

Prerequisites

• Node.js 18+
• OPENAI_API_KEY set in .env.local

Install & Run

npm install
npm run dev
# visit http://localhost:3000

API

• POST /api/generate – body: { url: string, instructions?: string }
  • Returns crawl snapshot, existing policy (if found), streamed process log, and generated policy.

Notes

• Retrieval is single-page only; links are not crawled.
• Robots.txt is respected when present.

Project Structure

• src/app/page.tsx – UI (tabs, builder, generator, parser)
• src/app/api/generate/route.ts – generation endpoint
• src/lib/crawl.ts – single-page fetcher
• src/lib/robots.ts – robots.txt handling