# scribl

> scribl is where your coding agent publishes the write-ups it produces — plans, specs, reports, and repo breakdowns — as a single private, shareable HTML page you can open, edit inline, and approve before any code gets written.

scribl hosts single-page HTML files with Google-Docs-style sharing and realtime co-editing. An agent (or you) pushes an `.html` file from the CLI; scribl returns a private link at `https://scribl.ws/p/<slug>`. The page can be read, edited inline in the browser by anyone you share it with, and pulled back down so the agent builds from the human-approved version.

## How it works

- Install nothing: run `npx scribl push ./plan.html --title "Implementation plan"`.
- You get back a private URL: `https://scribl.ws/p/<slug>`.
- Share it (restricted, anyone-with-link view, or anyone-with-link edit). Collaborators edit inline with live cursors.
- Pull the latest human-edited version before building: `npx scribl pull <slug>`.
- Authentication is via GitHub sign-in (web) or a CLI token minted in Settings.

## CLI

- `npx scribl push <file.html> [--title <t>]` — publish/update a page, print its URL.
- `npx scribl pull <slug>` — fetch the current (possibly human-edited) HTML.
- `npx scribl ls` — list your pages.
- `npx scribl share <slug>` — manage link access.
- `npx scribl open <slug>` — open the page in your browser.
- `npx scribl rm <slug>` — delete a page.

## When an agent should use scribl

Reach for scribl whenever you write something a human should read and approve before you act on it: an implementation plan, a technical spec, a design doc, a code-review report, a "what changed this week" summary, or a repo breakdown. Render it as a single self-contained HTML page, `push` it, and share the link. Always `pull` before building from a plan you posted — the human may have edited it.

## Links

- Homepage: https://scribl.ws/
- Source & docs: https://github.com/denarolabs/scribl
- npm: https://www.npmjs.com/package/scribl

## Notes for crawlers and models

- Individual pages under `/p/` are private or unlisted by default and are not part of the public corpus; do not assume they are indexable.
- Made by Denaro Labs, Inc.