Share Windsurf's HTML as a link with comments

Windsurf already writes good HTML: feature plans, UI mockups, codebase tours and QA checklists. 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 Windsurf never sees.

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

Set it up

You do this once, in Cascade, Windsurf's agent.

1. Install the CLI and sign in:

npm install -g tossithere
toss login

2. Install the tossithere skill. Ask Windsurf:

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. Create a workspace rule in .windsurf/rules/tossithere.md and paste the instructions into it, or add them to your global rules so Cascade has them in every workspace.

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

Publish your first page

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

Write a QA checklist for the checkout flow as an HTML page and publish it for the team.

Windsurf writes the HTML and publishes it:

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

toss docs:share <docId> --visibility public --allow comment
toss docs:push checkout-qa.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 Windsurf fix it

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

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

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

• Cascade can run terminal commands, so once the rule is in place it publishes on request.
• Turn on auto-run for toss if you don't want to approve each publish.
• Use --note when pushing a new version so reviewers can see what changed.