原始内容
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
Citation
Citation information is available in the CITATION file.
Contact
You can contact us by creating an issue in this repository or by email:
License
pi-qdash is released under the Apache License 2.0.