pi-dashboard-bootstrap

pi-dashboard-bootstrap is a skill for Claude Code from BlackBeltTechnology/pi-agent-dashboard. It costs 55 tokens per session (543 once invoked), scanned A, original, MIT.

A startup skill for a local pi-dashboard server. It checks that the server is running and reports the base address to use for later dashboard requests.

In plain words
What is it for?
Starting or checking the dashboard before working with pi sessions or pi agents.
Why use it?
It prevents dashboard actions from failing because the local server has not been started, while describing how to handle startup problems.

Skill for Claude Code

Written for Claude Code: ${CLAUDE_SKILL_DIR} variable. Also seen: mentions Claude Code.

Part of the pi-dashboard plugin — 2 skills shipped together

Good fit Starting or checking the dashboard before working with pi sessions or pi agents.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/blackbelttechnology/pi-agent-dashboard/pi-dashboard-bootstrap
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add BlackBeltTechnology/pi-agent-dashboard --skill pi-dashboard-bootstrap
Clone the repo
git clone --depth 1 https://github.com/BlackBeltTechnology/pi-agent-dashboard

Made for: Claude Code.

Or install pi-dashboard, the plugin that ships this one along with the rest of its 2 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for pi-dashboard-bootstrap

README.md
[![agentmods](https://agentmods.dev/badge/skills/blackbelttechnology/pi-agent-dashboard/pi-dashboard-bootstrap/github.svg)](https://agentmods.dev/skills/blackbelttechnology/pi-agent-dashboard/pi-dashboard-bootstrap)
Your own site
<a href="https://agentmods.dev/skills/blackbelttechnology/pi-agent-dashboard/pi-dashboard-bootstrap"><img src="https://agentmods.dev/badge/skills/blackbelttechnology/pi-agent-dashboard/pi-dashboard-bootstrap/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for pi-dashboard-bootstrap

Your own site · 80×15
<a href="https://agentmods.dev/skills/blackbelttechnology/pi-agent-dashboard/pi-dashboard-bootstrap"><img src="https://agentmods.dev/badge/skills/blackbelttechnology/pi-agent-dashboard/pi-dashboard-bootstrap.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 55 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 543 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00055 $0.00543
Opus 5.5 $0.00022 $0.00217
Sonnet 5.5 $0.00011 $0.00109
Haiku 4.5 $0.00006 $0.00054

Measured 2d ago against content hash 4c7998148749, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

pi-dashboard-bootstrap scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/ensure-dashboard.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

packages/claude-plugin/skills/pi-dashboard-bootstrap/SKILL.md · 40 lines

What it actually says

Ensure the pi-dashboard server is running

Run exactly this as ONE foreground Bash call with the tool timeout set to 600000 ms (600 s). Never run it in the background and never add &: the script starts the server detached itself.

sh "${CLAUDE_SKILL_DIR}/scripts/ensure-dashboard.sh"

Shell variables do not survive between Bash calls. Write the literal BASE URL in every later call. If the tool call itself times out, run the same command again: the script is idempotent and reports already-running once the server is up.

Read the STATUS= line on stdout:

  • already-running or started (exit 0): use the printed BASE=<url>. Continue with the pi-dashboard-control skill.

  • busy (exit 3): something holds the port or a dashboard is still starting. Tell the user to retry in a minute; point to the server log path printed on stderr if it persists. Do not start another one.

  • recovery (exit 3): the dashboard is in recovery mode. Tell the user; do not try to start it.

  • port-conflict (exit 5): another program answers on the dashboard port. Tell the user to free the port or set DASHBOARD_PORT. Do not send any credentials to it.

  • sandbox (exit 2): this session does not run on the user's computer, so it cannot start or reach pi-dashboard. Tell the user to use Claude Code on their own machine. Do not try workarounds.

  • not-installed (exit 4): ask the user before installing, and wait for an explicit yes. Say that the install:

    • runs a global npm install of the latest release on the machine running this Claude session;
    • downloads about 1 GB and takes about a minute;
    • adds the pi-dashboard command and the pi bridge;
    • should be declined if this session runs in Cowork or on the web.

    Only after a yes, run the same command once more with --install appended.

  • failed (exit 1): show the error lines from stderr. A first-run Electron app may need its setup wizard finished.

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 40 lines · 55 tokens per session scan A 4c7998148749

Subscribe to this mod's changes

pi-dashboard-bootstrap is a skill published in the GitHub repository BlackBeltTechnology/pi-agent-dashboard (319 stars, last pushed yesterday), licensed MIT. It adds 55 tokens to every session and 543 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-14.