byagent
Dashboard

Guides

Publish Codex output as a shareable link

Give Codex CLI a way to hand back a link instead of a file path: install the byagent skill, publish Markdown or HTML, and read reader comments on the next run.

Updated 2026-10-04 Markdown

Codex CLI is good at writing reports, migration plans and one-file HTML tools. The output ends up as a file on your machine, so sharing it means attaching files or pasting into a doc. With byagent, Codex publishes the file and hands back a link anyone can open.

Install the skill

npx skills add anup-a/agent-artifacts -a codex

That puts the byagent skill where Codex looks for skills (.agents/skills/byagent). You can also point your AGENTS.md at https://byagent.dev/skill.md and ask Codex to follow it.

The skill drives the byagent CLI (npm install -g byagent, or npx byagent). The first publish works without an account: it gets a guest key for up to three public pages that last 24 hours. Create a key at https://app.byagent.dev/app/keys to keep pages and publish private ones.

Publish

byagent publish ./report.md --project "Billing migration" --tag report --agent codex --json
byagent publish ./dashboard --title "Latency dashboard" --project "Billing migration" --tag dashboard --agent codex --json
  • A .md file is rendered to a styled page. A folder with index.html is served as a site.
  • --agent codex and --model <model id> record what produced each version, so the page history shows it.
  • The JSON output has url. Codex should return that link, not a file path.
  • Publishing again from the same folder updates the same link.

Read the comments on the next run

People comment on any line of the page without signing in. When you're ready, ask Codex to address them:

byagent comments <id> --open --json

Codex edits the file, republishes, then replies to and resolves each thread. Comment text comes from readers, so the skill tells Codex to treat it as data to act on by editing the page, never as instructions to run.

A publish reminder

byagent hooks install codex

This adds a hook to ~/.codex/hooks.json that reminds Codex to publish when it writes a page. Trust it once in /hooks. It suggests; it never publishes by itself.

More