inspect

Masque Inspect Command

Display the complete details of a masque — all components plus attributes.

Instructions

1. Determine target:

   • If no argument or self → inspect the currently active masque
   • If a name is provided → inspect that masque directly

2. If inspecting self (no arg or "self"):

   • Read .claude/masque.session.yaml to check current state
   • If active.name has a value, construct path from name + source:
     • If source is private: ${MASQUES_HOME:-~/.masques}/<name>.masque.yaml
     • If source is shared: ${CLAUDE_PLUGIN_ROOT}/personas/<name>.masque.yaml
   • If active.name is null or file doesn't exist: report "No masque active. Use /don <name> to adopt one."

3. If inspecting by name — use the masques-cli CLI, the one authoritative resolver shared by this plugin and the Masques MCP server (PRD v1.2 M7):

   Locate the CLI ($MASQUE): use masques-cli if on PATH (installed via uv tool install "${CLAUDE_PLUGIN_ROOT}/services/mcp"), otherwise uv run --project "${CLAUDE_PLUGIN_ROOT}/services/mcp" masques-cli.

   $MASQUE inspect <name> --json
   

   • The CLI resolves private ${MASQUES_HOME:-~/.masques} over bundled personas/ and returns name, version, source, lens, context, attributes, rubric, has_rubric, spinnerVerbs.
   • If it exits non-zero (not found), relay its diagnostic and suggest /list.

4. Display the full masque:

   ═══════════════════════════════════════════════════════════════
   [Name] v[version]
   ═══════════════════════════════════════════════════════════════
   
   [tagline]
   
   ── Attributes ──────────────────────────────────────────────────
   Domain:     [domain]
   Stack:      [stack]
   Style:      [style]
   Philosophy: [philosophy]
   
   ── Context ─────────────────────────────────────────────────────
   [context block - full content]
   
   ── Lens ────────────────────────────────────────────────────────
   [full lens content]