pi-multica-doctor

Multica workspace health, one command

Packages

Package details

extension

Install pi-multica-doctor from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:pi-multica-doctor

Package: pi-multica-doctor
Version: 0.1.0
Published: Aug 9, 2026
Downloads: 148/mo · 7/wk
Author: eiei114
License: MIT
Types: extension
Size: 22.2 KB
Dependencies: 0 dependencies · 1 peer

Pi manifest JSON

{
  "extensions": [
    "./extensions"
  ],
  "commands": {
    "multica-doctor-check": "./bin/multica-doctor-check.js"
  }
}

Security note

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

README

pi-multica-doctor

Multica workspace health, one command.

pi-multica-doctor is a Pi extension that runs read-only Multica workspace diagnostics in a single compact JSON report. It checks auth context, CLI syntax drift, registry table integrity, feedback JSONL well-formedness, and stuck in-progress runs.

This repository currently ships a walking skeleton: the multica_doctor_check tool and CLI expose the stable JSON contract while probe logic is being added slice by slice. Auth context, CLI syntax, and registry table checks are implemented; the remaining probes are still being added.

Install

pi install npm:pi-multica-doctor

Install into the current project:

pi install npm:pi-multica-doctor -l

Usage

Pi slash command

/multica-doctor-check

Pi tool

Agents can call multica_doctor_check directly. The tool returns JSON like:

{
  "checks": [
    "auth_context",
    "cli_syntax",
    "registry_tables",
    "feedback_jsonl",
    "stuck_runs"
  ],
  "pass": true,
  "fail_count": 0,
  "failures": []
}

CLI

npx multica-doctor-check

Development

npm install
npm run ci
pi -e .

Scope

Read-only diagnostics only
No secret handling beyond token presence checks (implemented in slice 02)
No auto-repair or status mutations
Designed to delegate to upstream multica doctor when it ships

Related docs

Vault PRD: 4_Project/OSS/pi-multica-doctor/Docs/PRD.md
Incubator decision: 4_Project/Multica-Agent-Strategy/Incubations/2026-W27-pi-multica-doctor/DECISION.md

License

MIT