Share Warp's HTML as a link with comments

Turn the HTML Warp writes into a private page that opens on any screen. Collect comments on the exact spot, and Warp fixes it on the same link.

Sign up free

Updated · Instructions go in AGENTS.md

Warp already writes good HTML: incident timelines, log analyses, runbooks and infrastructure reports. The hard part is what happens next. A file on your laptop doesn't open properly on a phone, and feedback ends up in a chat thread that Warp never sees.

tossithere fixes that. Warp runs one command, and the HTML is live at a private link that opens anywhere. People comment on the exact element or sentence they mean, and Warp reads every comment, fixes the page and publishes v2 on the same link.

Set it up

You do this once, in Warp's agent mode.

  1. Install the CLI and sign in:
npm install -g tossithere
toss login
  1. Install the tossithere skill. Ask Warp:

Install the tossithere skill from https://tossithere.com/skill.md and use it whenever you make HTML for me.

Prefer to keep it in the repository? Copy the instructions from this page instead. Paste the instructions into AGENTS.md (or WARP.md) at the root of your project, or save them as a rule in Warp so every agent conversation has them.

That's it. Warp now knows how to publish, share, read comments and push new versions.

Publish your first page

Ask Warp for something you'd normally get as a wall of text:

Read the last hour of the API logs, find what caused the 500s, and publish an incident page.

Warp writes the HTML and publishes it:

toss docs:push incident-api-500s.html --json
# -> https://tossithere.com/d/incident-api-500s-8fa2

The page is private to you. Open it on your laptop or your phone.

Share it and collect comments

When someone else should see it, ask Warp to share it, or publish straight into a team workspace:

toss docs:share <docId> --visibility public --allow comment
toss docs:push incident-api-500s.html --team <slug>

Reading needs no account. Commenting takes a Google sign-in, so every comment has a name on it. Reviewers click any element or highlight any text and type.

Let Warp fix it

Tell Warp: "Read the comments and fix the page." It runs:

toss comments:list <docId> --unresolved --json
toss docs:push incident-api-500s.html --id <docId> --note "what changed"

Every comment arrives with the exact markup it points at, so Warp edits the right line instead of guessing. The new version goes to the same link, and older versions stay readable with their own comments.

Tips for Warp

  • Warp's agent lives in the terminal, so publishing is the most natural step: it already runs the commands.
  • Incident pages are a good fit. Teammates comment on the timeline, and the agent updates the same link as you learn more.
  • Save the instructions as a Warp rule to use them outside a repository.

Questions about Warp

Does tossithere work with Warp?

Yes. tossithere is a command-line tool, and Warp can run it like any other command. There's no plugin or extension to install.

Do I need Warp's paid plan?

No. Any Warp agent session that runs shell commands can publish.

Can I publish from a Warp workflow?

Yes. toss docs:push is a normal command, so it fits in any workflow or script.

Is it free?

Viewing and commenting are free on every plan. Publishing is free for up to 10 documents. Pro is $10 a month for unlimited documents, and Team is $39 a month flat for a shared workspace.

Works with the rest of your agents, too.

Every page lands in the same place, with the same links, sharing and comments, whichever agent made it.

Whatever Warp makes, toss it here.

Free for up to 10 documents. Viewing and commenting are free on every plan.

Sign up free