pi-qdash

A pi extension for querying QDash from pi. 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.

Usage

Install from npm:

pi install npm:@orangekame3/pi-qdash

Try from npm without installing:

pi -e npm:@orangekame3/pi-qdash

For local development, install dependencies in this repository:

npm install

Try the local package temporarily from the repository root:

pi -e .

Install the local package for regular use:

pi install "$(pwd)"

Or install it from GitHub:

pi install git:github.com/orangekame3/pi-qdash

Tools

• qdash_config_info: inspect profiles and non-secret connection settings
• Dedicated read-only tools:
  • qdash_list_chips, qdash_get_default_chip
  • qdash_get_chip_metrics, qdash_list_chip_qubits, qdash_list_chip_couplings
  • qdash_get_timeseries, qdash_plot_timeseries
  • qdash_list_task_results, qdash_get_task_result
  • qdash_list_issues
  • qdash_list_flows, qdash_get_flow
  • qdash_list_executions, qdash_get_execution, qdash_wait_execution, qdash_compare_executions
  • qdash_list_ai_reviews, qdash_get_provenance_stats
  • qdash_list_forum_posts, qdash_get_forum_post, qdash_list_forum_replies
  • qdash_get_figure, qdash_get_task_figures, qdash_recent_calibration_figure
• Harness overview and insight tools:
  • qdash_investigate (natural-language-friendly read-only correlation of recent calibration, target history, failures, issues, and Forum context)
  • qdash_compare_calibration (compare repeated calibration output parameters)
  • qdash_dashboard
  • qdash_dashboard_insights
  • qdash_recent_calibration_summary
  • qdash_recommend_next_action
  • qdash_triage_overview
  • qdash_target_report (target-level read-only incident/operations report)
  • qdash_plan_calibration (safe dry-run calibration plan; never executes)
  • qdash_validate_calibration (post-task validation gates; read-only)
  • qdash_degradation_report (provenance drift, changes, lock, and downstream recommendations)
• Agent calibration workflow tools:
  • qdash_create_agent_session
  • qdash_get_agent_session
  • qdash_submit_agent_action
  • qdash_get_agent_action, qdash_list_agent_actions, qdash_wait_agent_action
  • qdash_list_agent_action_candidates
  • qdash_execute_agent_action
  • qdash_commit_agent_candidate, qdash_commit_agent_campaign_candidates
  • qdash_get_agent_candidate_commit, qdash_apply_agent_candidate_commit, qdash_wait_agent_candidate_apply
• qdash_query: fallback for read-only queries that do not yet have a dedicated tool
• qdash_raw_get: call read-only GET endpoints not covered by qdash_query through the qdash-client transport

Secrets such as api_token, passwords, and Cloudflare Access secrets are redacted from tool output. Write-oriented agent/forum workflow tools are approval-gated: interactive pi shows a confirmation prompt, and non-interactive runs require confirmWrite: true.

Forum read tools render compact boxed summaries for list/detail/reply views. Figure tools fetch calibration PNG/JSON figures by path or task result through qdash-client helpers, and render images in interactive TUI. Forum evidence can be previewed read-only with qdash_preview_forum_evidence_reply, then published through confirmation-gated qdash_create_forum_evidence_reply; other forum writes include qdash_create_forum_post and qdash_update_forum_post. The evidence-reply helper builds a markdown reply from a task result, embeds figures so they are visible in the forum, links recent same-task history, and marks the reply with — 🤖 by pi-qdash.

Skill

This package also provides /skill:qdash, which guides pi to choose the right QDash tools, avoid exposing secrets, and prefer read-only operations.

Commands

/qdash-setup [profile] [chip_id]
/qdash-use-profile <profile>
/qdash-use-chip [chip_id]
/qdash-use-agent-session <session_id>
/qdash-context
/qdash-dashboard [limit]
/qdash-target-report qid <qid> | coupling <coupling_id>
/qdash-plan-calibration
/qdash-degradation-report
/qdash-refresh [limit]
/qdash-clear-context
/qdash-config [profile]

For the common path, install the package and run /qdash-setup mackerel 144Qv1 in interactive pi. The setup command stores the session-local profile/chip context, refreshes the footer status line, and opens the dashboard widget.

These commands manage session-local QDash context, update the pi status/widget, show or refresh a themed compact QDash dashboard, and show non-secret QDash configuration details. Tools use the current profile/chip context when their parameters are omitted. In interactive mode, the highlighted footer status line shows the active QDash profile, chip, and agent session.

qdash_dashboard and qdash_triage_overview provide boxed compact text output for non-interactive runs and custom TUI renderers for nicer interactive tool results. qdash_target_report correlates one qubit/coupling's recent task results, failures, open issues, forum posts, and a conservative next-action recommendation; it is read-only and never executes calibration. qdash_plan_calibration turns that evidence into a confirmation-gated dry-run runbook with explicit safety gates. Pass color: true to emit ANSI-colored text output in terminal-oriented non-interactive usage.

Development

npm run check