@oqtopus-team/pi-qdash

Pi extension for querying QDash via @oqtopus-team/qdash-client

Packages

Package details

extensionskill

Install @oqtopus-team/pi-qdash from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@oqtopus-team/pi-qdash
Package
@oqtopus-team/pi-qdash
Version
0.1.3
Published
Jul 27, 2026
Downloads
187/mo · 187/wk
Author
orangekame3
License
Apache-2.0
Types
extension, skill
Size
241.6 KB
Dependencies
1 dependency · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/qdash.ts"
  ],
  "skills": [
    "./skills"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

OQTOPUS logo

pi-qdash

CI npm version License slack

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.