byagent
byagent
The hand-back is the returned published URL (public: https://byagent.dev/a/<id>/; private: https://app.byagent.dev/app/view/<id>/). Chat markdown, a local .md path or a local HTML path is not done.
Markdown or HTML?
| The deliverable is… | Write | Publish |
|---|---|---|
| Prose: report, plan, notes, spec, analysis, findings, README, comparison table | Markdown (.md) |
byagent publish ./doc.md … |
| Layout or interaction: dashboard, tool, mockup, gallery, chart-heavy page, landing page | HTML (index.html + assets) |
byagent publish ./site … |
Default to Markdown. It is faster to write, comments attach to real text, and the renderer already gives light + dark, a table of contents, anchors, GFM tables, task lists and highlighted code. Reach for HTML only when the page needs something Markdown cannot express.
Publish finished pages without waiting to be asked, and always hand the URL back so the user sees exactly what went out. Pages are public unless you pass --private: use --private for anything internal (client work, unreleased plans, content from a private repo), and ask the user first when you are unsure. Never publish secrets, credentials, .env contents or personal data.