Workflow
How to share a coding-agent plan
Share a coding-agent plan without pasting it into chat: keep one canonical source, choose private or public access, and let people or agents read the same URL.
Use one URL for people and agents
A Hostplan share URL is content-negotiated. A browser receives the rendered plan viewer; curl or a client requesting Markdown receives the original plan source. Both readers refer to the same plan id and current revision.
# Human: open the URL in a browser
https://plans.host-plan.com/p/a3f9c2?code=KRWT
# Agent or script: fetch the same URL
curl -fsSL 'https://plans.host-plan.com/p/a3f9c2?code=KRWT'Share privately by default
- 1
Add the plan
hsp add stores it locally and, when signed in, pushes the same id to your deployment.
- 2
Use the coded URL
The bare URL asks for a four-letter code; the coded URL opens directly for the recipient.
- 3
Rotate when needed
hsp rotate issues a new code and invalidates the old coded link.
- 4
Publish deliberately
hsp publish removes the code only when anyone with the bare URL should be able to read it.
Choose the access model
Local only
hsp add --local. Nothing is uploaded; the URL points at the local viewer and only works on that machine.Private hosted link
Public by link
hsp publish for material intentionally readable without a code. Hostplan still keeps plan pages out of search indexes.Repository file
PLAN.md instead of creating another sharing layer.What not to put in a shared plan
Do not include credentials, API tokens, private keys, production customer data, or other secrets. A four-letter code is casual access control, not cryptographic protection. Refer to secret locations or secure systems rather than copying sensitive values into the plan.