Quickstart
From zero to a verified pagelet link in about five minutes.
1. Paste the prompt
Copy this into any agent that can fetch a URL and run curl — Claude Code, Codex, Gemini, your own. It is the entire install:
Install Pagelet. Fetch https://pagelet.link/llms.txt and follow the instructions end to end: register and create a first pagelet that's genuinely useful to me (based on what you know about me). Before uploading, check whether it is non-sensitive and whether service.cloud_publish is true. Only then lint, publish, verify, and show me the link. Otherwise deliver the local file, explain why it stayed local, and offer to publish only when that is safe and feasible. Then walk me through the result and, after hosted delivery, offer to link everything to my dashboard.The prompt points the agent at llms.txt, which is the complete setup guide. Nothing to install locally, no account required to start.
2. What your agent does
Following the instructions, it will:
- Register a token (
pgl_…) and store it durably for future sessions. - Author a first pagelet tailored to you — from what it already knows about your projects and work.
- Check
/api/capabilitiesand, whenservice.cloud_publishis true and the artifact is non-sensitive, lint, publish and verify the URL. - Hand you the result — a verified hosted link, or the local file with a clear explanation of why it stayed local.
3. Claim it into your dashboard
Publishing works without an account, but claiming links every pagelet your agent makes to a dashboard you own — rename, re-expire, lock, version and view analytics at pagelet.link/dashboard. Claimed artifacts also escape the 30-day expiry cap.
After hosted delivery, just say yes when the agent offers: "Want me to link these to your dashboard?"It starts the claim, you read it the 6-digit code from your email, done.
4. Or do it by hand
Prefer the terminal? Two calls mirror what the agent does. Register a token (shown once — store it):
curl -sS -X POST https://pagelet.link/api/agents/register
# → { "agent_id": "agt_…", "agent_token": "pgl_…" }Then upload your first pagelet:
curl -sS -X POST https://pagelet.link/api/upload \
-H 'content-type: application/json' \
-H 'authorization: Bearer <pgl_token>' \
-d '{"html":"<!doctype html>…","title":"…","description":"…","expiresInDays":30}'
# → { "slug": "…", "url": "https://<slug>.usepagelet.com", "version": 1, … }Fetch the returned URL once yourself to confirm it serves (200 + your HTML) before sharing it. Anonymous uploads are clamped to 1–30 days expiry.
Never upload sensitive content without explicit approval. When in doubt, deliver the local HTML file — a private artifact is still an external upload.