Share Zed's HTML as a link with comments

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

Sign up free

Updated · Instructions go in a .rules file

Zed already writes good HTML: code walkthroughs, performance reports, RFCs and review notes. 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 Zed never sees.

tossithere fixes that. Zed 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 Zed reads every comment, fixes the page and publishes v2 on the same link.

Set it up

You do this once, in Zed's agent panel.

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

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 a .rules file at the root of your project. Zed's agent also reads AGENTS.md and CLAUDE.md if you already keep instructions there.

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

Publish your first page

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

Profile the startup path and publish a page with the slowest ten functions and what to do about them.

Zed writes the HTML and publishes it:

toss docs:push startup-profile.html --json
# -> https://tossithere.com/d/startup-profile-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 Zed to share it, or publish straight into a team workspace:

toss docs:share <docId> --visibility public --allow comment
toss docs:push startup-profile.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 Zed fix it

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

toss comments:list <docId> --unresolved --json
toss docs:push startup-profile.html --id <docId> --note "what changed"

Every comment arrives with the exact markup it points at, so Zed 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 Zed

  • Zed's agent runs terminal commands through its tools, so publishing is one tool call.
  • External agents you run in Zed, like Claude Code or Gemini CLI, pick up their own instruction files as well.
  • Read the link in your browser while you keep coding in Zed.

Questions about Zed

Does tossithere work with Zed?

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

Do I need a Zed extension?

No. tossithere is a CLI. Zed's agent runs it in the terminal.

Can I use it with external agents inside Zed?

Yes. Any agent Zed runs that can use the terminal can publish with the same commands.

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 Zed makes, toss it here.

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

Sign up free