Pubblue

Publish and visualize output via the pubblue CLI, with live P2P browser sessions.

Use this skill when the user asks about publishing, showing, or visualizing agent output on pub.blue.

Required CLI Version

Use pubblue CLI 0.6.9+.

pubblue --version
npm i -g pubblue@latest

Setup

# One-time auth
pubblue configure --api-key pub_KEY
# or
echo "pub_KEY" | pubblue configure --api-key-stdin

Key source: https://pub.blue/dashboard

By default, config is stored at ~/.openclaw/pubblue/config.json. Override config directory with PUBBLUE_CONFIG_DIR env var (useful in sandboxed environments). For OpenClaw bridge mode, daemon runtime defaults to OPENCLAW_WORKSPACE=~/.openclaw/workspace.

Core Commands

pubblue create page.html
pubblue create --slug demo --title "Demo" --public page.html
cat notes.md | pubblue create

pubblue get <slug>
pubblue get <slug> --content

pubblue update <slug> --file next.html
pubblue update <slug> --title "New title" --public

pubblue list
pubblue delete <slug>

Notes:

• Pub is built for agent-driven output sharing and live visualization.
• Pubs are private by default.
• create supports --public/--private, --title, --slug, --expires.
• update supports --file, --title, --public/--private, --slug.
• Content is optional: a pub can be live-only.

Going Live

Live is browser-initiated: the user opens the pub page and clicks Go Live; the daemon answers.

1. Start the agent daemon:

pubblue start --agent-name "<agent-name>"
# optional explicit mode:
pubblue start --agent-name "<agent-name>" --bridge openclaw
pubblue start --agent-name "<agent-name>" --bridge claude-code

2. Check runtime status:

pubblue status

3. Send replies:

pubblue write "Hello"
pubblue write -c canvas -f /tmp/view.html

4. Read incoming (manual/debug):

pubblue read --follow -c chat
pubblue read --all

5. Stop daemon:

pubblue stop

6. Validate end-to-end:

pubblue doctor
pubblue doctor --wait-pong --timeout 30
pubblue doctor --skip-chat --skip-canvas

Important:

• write waits for delivery confirmation.
• read is consumptive; avoid multiple read --follow consumers on the same channel.

Advanced Details (On Demand)

Only when needed:

• Show effective saved config: pubblue configure
• Inspect runtime and bridge state: pubblue status
• See command-specific options: pubblue <command> --help