Aron PrinsandClaude Opus 5.5
ee9de7fb26
Recaptures every docs screenshot against `v2026.1106.0` (`d69631b0`). 196 of 278 were stale, and some contradicted the text, such as the removed **Run with provider trace** button and the old roster tabs. ## What changed - **Images:** 276 of 276 captured in both themes; 271 PNGs changed. Every registry entry is stamped `v2026.1106.0`. - **Pipeline:** `seed.mjs`, `capture.mjs`, `routes.mjs`, `config.mjs` and `github-review-fixture.mjs` now match this release's UI. No targets were dropped. - **Caption:** `experimental/file-viewer.md` now describes what its image shows. ## Check these - **Staged state:** the budget banner is removed in the browser on `dashboard/dashboard-overview`, `experimental/server-info` and `onboarding/sidebar-new-company-button`. The budget pages keep their real incidents. The seed also turns off hard stops outside the Budget Demo agents, and marks agents stuck in `verifying` as ready, so demo pages aren't paused. - **`experimental/file-viewer-browse`:** opening the task **Files** tab crashed the app at the tag on the seeded instance (`Maximum update depth exceeded` in `SidePanelTabs`), so the image shows a file open in its side panel instead. `file-viewer.md` still lists `g f` as an entry point. ## Review coverage All 140 light images were checked at contact-sheet size, so fine text wasn't readable that way. 44 images from the final run, 24 light and 20 dark, were opened at full size. The remaining dark images weren't viewed. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Opus 5.5 <[email protected]>
Paperclip Docs
Source for the Paperclip documentation site — user guides, API and CLI reference, adapter docs, and deployment notes.
Read the docs: https://docs.paperclip.ing/
What's inside
- Guides — Getting started, core concepts, and day-to-day usage.
- API reference — Control-plane endpoints and payload schemas.
- CLI reference —
paperclipcommand surface. - Adapters — Plugin authoring and the integrations catalogue.
- Deploy — Self-hosting, upgrades, and operational guidance.
The site is a single static shell that renders the Markdown files in docs/ directly — no framework, no build step required to read the raw pages.
Build and deployment
Build a release bundle locally with:
npm run docs:build
Cloudflare Pages is connected directly to paperclipai/paperclip-docs through GitHub. There is no normal Wrangler publish step for this repo:
- Pushes to
maindeploy production athttps://docs.paperclip.ing/. - Pushes to other branches create Cloudflare Pages preview/canary deployments.
- Canary URLs are created by Cloudflare for each deployment, for example
https://92b9a99c.paperclip-docs-74t.pages.dev. Use the URL shown in the Cloudflare Pages deployment row or GitHub deployment/check for the pushed branch and commit.
That auto-deploy is not guaranteed — it has silently failed to fire on a push to main before. After anything reader-facing lands, check the live site rather than the merge, and republish by hand if it's stale:
npm run docs:build
npx wrangler pages deploy .site --project-name paperclip-docs --branch main
Contributing
Spotted a typo, a broken link, or something that could be clearer? There are two easy paths, both linked from the footer of every docs page:
- Suggest an edit — opens the underlying Markdown file in GitHub's web editor. Make the change and submit a PR without leaving the browser.
- Report an issue — opens a prefilled Docs feedback issue with the page URL already attached.
For larger changes, fork the repo and open a PR against main. Screenshots live under docs/user-guides/screenshots/{light,dark}/ and should be provided in both themes when replacing UI captures.
Community
License
Copyright (c) 2026 Paperclip Community.
The Paperclip software is open source — see the main paperclip repository for its license.
The documentation in this repository is licensed under Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International (CC BY-NC-ND 4.0). You may read and share it for non-commercial purposes with attribution. Commercial use of any kind requires prior written permission from the copyright holders. See LICENSE for the full text.
Unlisted hosted beta guide
docs/hosted-beta.md is built at /hosted-beta/ by site/build-release.mjs.
It reuses the full docs shell and initializes page tools without adding the page to the navigation/search manifest.
Keep it out of site/content.json: it is deliberately absent from navigation,
search, homepage listings, previous/next links, and the sitemap. It has a
noindex meta tag; this is a public page, not an access-controlled document.
Run node scripts/verify-unlisted-beta.mjs to verify root/subpath builds and
exclusion from discovery. Preview with npm run docs:build and npm run docs:serve.