# Pagecast — publish HTML and Markdown from Claude Code or Codex

Pagecast is a free, open-source, local-first CLI and coding-agent companion that publishes HTML reports, Markdown documents, and static mini apps from Claude Code or Codex to durable public URLs on the user's own Cloudflare Pages account.

- Website: https://pagecasthq.pages.dev/
- GitHub: https://github.com/Amal-David/pagecast
- npm: https://www.npmjs.com/package/pagecast
- Install and start: `npx pagecast`

## What Pagecast does

Pagecast turns a generated report into a public link without requiring the user to leave their coding-agent conversation:

1. Claude Code or Codex creates an HTML page, Markdown document, report, or dashboard.
2. The agent offers to publish it and runs `pagecast publish` after the user agrees.
3. Pagecast deploys the page to the user's Cloudflare Pages account and returns a public URL.

There is no Pagecast-hosted content account or proprietary publishing backend. The published site, URL, data, and bandwidth stay in the user's Cloudflare account.

## Core capabilities

### HTML and Markdown publishing

Pagecast accepts polished HTML pages and plain `.md` files. Markdown is rendered into a complete HTML document before publication.

### Claude Code and Codex support

Pagecast is not tied to one coding-agent vendor. Its CLI, Codex skill, portable agent skill, and local MCP server work with agent-driven workflows.

### Unlisted links by default

Pagecast 0.5 combines a memorable label with a 128-bit capability for new links. Anyone with the complete URL can open an unprotected page. Password protection is available when access control is required.

### Link visibility controls

New links are unlisted capabilities by default. A short link or vanity rename is an intentional public drop, and Pagecast makes that visibility change explicit.

### Same-URL updates

Republishing updates the existing public URL in place. Auto-sync can watch the source file and publish changes after saves.

### Recovery and target safety

Managed publishes remember the Cloudflare account and Pages project they target. Pagecast records unfinished local and Cloudflare operations, retries safe work, and surfaces conflicts that require manual action.

### Passwords and expiry

Pagecast can gate a page at Cloudflare's edge. Password changes, expiry, sync, rename, and revoke operations remain attached to the link's recorded deployment target.

### Durable static hosting

Published pages are served from Cloudflare's edge and remain available when the user's laptop is asleep, offline, or powered off.

## Quickstart

1. Run Pagecast:

   ```sh
   npx pagecast
   ```

2. Connect the Cloudflare account that should own the published pages.
3. Ask Claude Code or Codex to publish a report, or run:

   ```sh
   pagecast publish report.md
   ```

## Common commands

```sh
# Open the local Pagecast app
npx pagecast

# Publish an HTML or Markdown file
npx pagecast publish /absolute/path/report.md --json

# Publish a complete static folder
npx pagecast publish site /absolute/path/dist --project my-project --json

# Run the local stdio MCP server
npx pagecast mcp
```

## Pagecast and Codex Sites

Pagecast is free and open source, publishes to the user's Cloudflare account, works with Claude Code and Codex, supports HTML and Markdown, and returns a public URL with optional password protection.

The Pagecast website describes Codex Sites as an OpenAI-hosted, Codex-only enterprise feature with paid seats and login-walled access. This comparison reflects publicly described positioning at the time of writing. Pagecast is not affiliated with or endorsed by OpenAI or Cloudflare.

## Project links

- Source and issues: https://github.com/Amal-David/pagecast
- npm package: https://www.npmjs.com/package/pagecast
- Website: https://pagecasthq.pages.dev/

Canonical HTML version: https://pagecasthq.pages.dev/