pi-qdash

Overview

pi-qdash is a pi extension for querying QDash, the large-scale QPU calibration platform in the OQTOPUS ecosystem, directly from the pi coding agent.

It uses @oqtopus-team/qdash-client and reuses existing QDASH_* environment variables or profiles from ~/.config/qdash/config.ini / $XDG_CONFIG_HOME/qdash/config.ini.

Key Features

• Read-only investigation: dedicated tools to inspect chips, qubits, couplings, calibration task results, executions, issues, and Forum posts. Secrets are redacted from tool output.
• Dashboards and insights: compact dashboards, triage overviews, target-level incident reports, degradation reports, and wiring insights.
• Agent calibration workflow: create agent sessions, submit and track agent actions, and commit/apply calibration candidates. Write operations are approval-gated.
• Figures: fetch calibration PNG/JSON figures and render them in the interactive TUI.
• Forum integration: read Forum posts and publish evidence replies built from task results.

Installation

Install pi first if needed:

npm install -g --ignore-scripts @earendil-works/pi-coding-agent

Install the published extension:

pi install npm:@oqtopus-team/pi-qdash

Or try it without installing:

pi -e npm:@oqtopus-team/pi-qdash

Requires pi v0.74.0 or later.

Quick Start

In interactive pi, set up the session context first:

/qdash-setup <profile> <chip_id>
/qdash-dashboard

See the documentation below for the full tool and command reference.

Developing from a Fork

For local development, clone your fork, install dependencies, and run pi against the checkout:

git clone https://github.com/<your-user>/pi-qdash.git
cd pi-qdash
npm install
npm run check
pi -e .

See Development Guide for the fork workflow, local testing, PR expectations, and the extension-vs-skill design policy.

Documentation

• Architecture
• Tool Reference
• Commands & Skills
• Development Guide
• Contributing

Citation

Citation information is available in the CITATION file.

Contact

You can contact us by creating an issue in this repository or by email:

• oqtopus-team[at]googlegroups.com

License

pi-qdash is released under the Apache License 2.0.