pubblue

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:

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

1. Check runtime status:

pubblue status

1. Send replies:

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

1. Read incoming (manual/debug):

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

1. Stop daemon:

pubblue stop

1. 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 --help