agent-whiteboard-setup

Installs and configures the Agent Whiteboard CLI, publishing servers, and Page Agent broker.

Updated Jun 24, 2026
One-click install
npx skills add https://github.com/dndplsidc/agent-whiteboard --skill agent-whiteboard-setup-dndplsidc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-whiteboard-setup
Source: https://github.com/dndplsidc/agent-whiteboard/tree/main/skills/agent-whiteboard-setup
Command: npx skills add https://github.com/dndplsidc/agent-whiteboard --skill agent-whiteboard-setup-dndplsidc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up Agent Whiteboard involves installing a Go CLI, choosing a publishing server, configuring origin trust, and starting a local Page Agent broker, with many ways to break existing configuration or provider state. This Skill guides an agent through exactly the setup mode the user needs while preserving existing configuration and credentials. ## Core Features & Use Cases - Mode-scoped setup: Installs the CLI and verifies an existing or local publishing server, or configures Page Agent with origin trust and a foreground or managed-daemon broker, only when requested. - State protection: Inspects and merges existing YAML configuration, never touches Pi, Codex, or Cursor credentials, and reuses a verified existing broker instead of starting duplicates. - Verification and rollback: Verifies health endpoints, listener ownership, and Page Agent connectivity without sending a model turn, then reports binary path, mode, and remaining manual steps. - Use Case: A user asks to set up Page Agent on their Mac for a remote whiteboard; the agent installs the CLI if missing, trusts the exact HTTPS origin, starts a supervised foreground broker, and verifies the connection in the browser without sending a model message. ## Quick Start Ask your agent to set up Agent Whiteboard for your project, stating whether you need publishing only or Page Agent, and which server origin to use.

Frequently Asked Questions about agent-whiteboard-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install the Agent Whiteboard CLI?

Install the CLI with go install github.com/dndplsidc/agent-whiteboard/cmd/agent-whiteboard@latest, which requires Go 1.25 or 1.26 on macOS or Linux. If an older version is already installed and exposes the upgrade command, run agent-whiteboard upgrade instead.

How do I set up Page Agent for a remote whiteboard?

Install the CLI, confirm a Pi, Codex, or Cursor provider is installed and authenticated, add the exact HTTPS origin with agent-whiteboard agent trust add, then start the broker with agent-whiteboard agent serve. Verify the connection through the whiteboard UI without sending a model message.

Does Agent Whiteboard work on Linux or only macOS?

Agent Whiteboard supports both macOS and Linux. The managed daemon for persistent broker operation is macOS-only; on Linux the broker runs in supervised foreground mode only.

Why does the Page Agent control not appear on my whiteboard?

The publishing server must enable viewer.local_agent.enabled in its configuration and be restarted. A reader cannot enable Page Agent on a remote server; the server operator must enable it.

Should I probe /healthz on the broker port 8568 to check readiness?

No. The broker does not expose the publishing server's /healthz or /readyz routes, so probing them on port 8568 gives misleading failures. Instead confirm the broker process owns a loopback listener on the configured agent.port and verify through the whiteboard UI.

Will setup modify my Pi, Codex, or Cursor credentials?

No. The setup never collects, copies, or edits provider credentials or native configuration, and never runs provider authentication. It only reports provider availability and any manual login steps such as cursor-agent login.