muggle

Plugin muggle in multiplex-ai/muggle-ai-works. Commands read from the repo's manifest — today.

Skills (46)

• m

  Explicit short alias for the `muggle` skill (router/menu). ONLY invoke when the user explicitly types `m` or `/m` — never auto-trigger from any other phrasing.

• mbt

  Explicit short alias for the `muggle-browser-task` skill. ONLY invoke when the user explicitly types `mbt` or `/mbt` — never auto-trigger from any other phrasing.

• mbugreport

  Explicit short alias for the `muggle-bug-report` skill. ONLY invoke when the user explicitly types `mbugreport` or `/mbugreport` — never auto-trigger from any other phrasing.

• mci

  Explicit short alias for the `muggle-ci-install` skill. ONLY invoke when the user explicitly types `mci` or `/mci` — never auto-trigger from any other phrasing.

• mcleanup

  Explicit short alias for the `muggle-cleanup` skill. ONLY invoke when the user explicitly types `mcleanup` or `/mcleanup` — never auto-trigger from any other phrasing.

• mdo

  Explicit short alias for the `muggle-do` skill. ONLY invoke when the user explicitly types `mdo` or `/mdo` — never auto-trigger from any other phrasing.

• mfeedback

  Explicit short alias for the `muggle-feedback` skill. ONLY invoke when the user explicitly types `mfeedback` or `/mfeedback` — never auto-trigger from any other phrasing.

• mimport

  Explicit short alias for the `muggle-test-import` skill. ONLY invoke when the user explicitly types `mimport` or `/mimport` — never auto-trigger from any other phrasing.

• minit

  Explicit short alias for the `muggle-init` skill. ONLY invoke when the user explicitly types `minit` or `/minit` — never auto-trigger from any other phrasing.

• mlogin

  Explicit short alias for the `muggle-login` skill. ONLY invoke when the user explicitly types `mlogin` or `/mlogin` — never auto-trigger from any other phrasing.

• mlogout

  Explicit short alias for the `muggle-logout` skill. ONLY invoke when the user explicitly types `mlogout` or `/mlogout` — never auto-trigger from any other phrasing.

• mpr

  Explicit short alias for the `muggle-pr-visual-walkthrough` skill. ONLY invoke when the user explicitly types `mpr` or `/mpr` — never auto-trigger from any other phrasing.

• mprefs

  Explicit short alias for the `muggle-preferences` skill. ONLY invoke when the user explicitly types `mprefs` or `/mprefs` — never auto-trigger from any other phrasing.

• mprfollowup

  Explicit short alias for the `muggle-pr-followup` skill. ONLY invoke when the user explicitly types `mprfollowup` or `/mprfollowup` — never auto-trigger from any other phrasing.

• mregen

  Explicit short alias for the `muggle-test-regenerate-missing` skill. ONLY invoke when the user explicitly types `mregen` or `/mregen` — never auto-trigger from any other phrasing.

• mregister

  Explicit short alias for the `muggle-register` skill. ONLY invoke when the user explicitly types `mregister` or `/mregister` — never auto-trigger from any other phrasing.

• mrepair

  Explicit short alias for the `muggle-repair` skill. ONLY invoke when the user explicitly types `mrepair` or `/mrepair` — never auto-trigger from any other phrasing.

• mrun

  Explicit short alias for the `muggle-run-view` skill. ONLY invoke when the user explicitly types `mrun` or `/mrun` — never auto-trigger from any other phrasing.

• mstatus

  Explicit short alias for the `muggle-status` skill. ONLY invoke when the user explicitly types `mstatus` or `/mstatus` — never auto-trigger from any other phrasing.

• mtest

  Explicit short alias for the `muggle-test` skill. ONLY invoke when the user explicitly types `mtest` or `/mtest` — never auto-trigger from any other phrasing.

• mtestlocal

  Explicit short alias for the `muggle-test-feature-local` skill. ONLY invoke when the user explicitly types `mtestlocal` or `/mtestlocal` — never auto-trigger from any other phrasing.

• mtestprep

  Explicit short alias for the `muggle-test-prepare` skill. ONLY invoke when the user explicitly types `mtestprep` or `/mtestprep` — never auto-trigger from any other phrasing.

• muggle-browser-task

  Perform a real action on a website or web app from a plain-English instruction — log in and do the thing: post, submit a form, create or update a record, change a setting, place an order, refund a charge, complete a multi-step flow. This skill is your logged-in browser, so lack of access is never a

• muggle-bug-report

  Use when the user wants to report a bug in Muggle AI itself (a muggle command or tool erroring, a run hanging, a dashboard or billing problem), or to list, check (BUG-4821) or reply to their bug reports. Not for bugs in the user's own app, nor a generated test script step that misbehaved (muggle-fee

• muggle-ci-install

  Add the Muggle walkthrough check to a repository's GitHub Actions. Use on muggle ci-install or when asked to require Muggle E2E in CI.

• muggle-cleanup

  Remove old Muggle browser runner versions and obsolete skills. Use on muggle cleanup. Not for cleaning up after a merged PR.

• muggle-do

  Take a feature request, spec, design, bug, or ticket and carry it autonomously to an opened pull request — write the code, test it, raise the PR. The PR carries real-browser proof: email-gated flows run through live test inboxes, logins through encrypted secrets, and prerequisite flows in test-graph

• muggle-feedback

  Use when the user wants to flag that a generated Muggle Test action script — or one specific step in it — did the wrong thing, so Muggle can analyze and regenerate affected scripts. Covers any report that a script or step is wrong, broken, or misbehaving (clicked the wrong element, step N did not wo

• muggle-init

  Run the Muggle onboarding walkthrough in the agent: saves first-time preferences and offers the CI check. Use on muggle init. To change one saved setting, use muggle-preferences.

• muggle-login

  Sign in to Muggle AI from the agent, or switch accounts. Use on muggle login or when asked to log in or re-authenticate to Muggle.

• muggle-logout

  Sign out of Muggle AI and clear stored credentials. Use on muggle logout or when asked to log out of Muggle.

• muggle-pr-followup

  Use when the user wants a pull request's incoming review feedback handled for them — it watches a PR's review threads and, each time a reviewer submits new comments, dispatches the work to address them. Covers one PR or several: with no PR named it auto-tracks every PR opened in this session, one wa

• muggle-pr-visual-walkthrough

  Post a visual walkthrough of Muggle AI E2E acceptance results to a pull request — pass/fail summary, step-by-step screenshots, and per-test-case dashboard links — rendered by the `muggle build-pr-section` CLI. Use whenever tests already ran and the user wants that evidence on the PR for reviewers: '

• muggle-preferences

  View, set, or reset Muggle AI preferences that control testing behavior. Use when the user asks to see their muggle settings, what a setting does, which setting controls a behavior (stop the login prompt, skip auto-rebase), where the settings live, or to change, configure, or reset one. Route these

• muggle-register

  Create a new Muggle AI account: sign up or register.

• muggle-repair

  Diagnose and fix a broken Muggle AI installation. Use when user types muggle repair or asks to fix Muggle Test setup.

• muggle-run-view

  Show a local Muggle test run's steps beside the frames they produced. Use on muggle run-view or when asked to view or replay what a local run did.

• muggle-status

  Check the health of the user's Muggle AI installation and diagnose why it's misbehaving — MCP server connectivity, tool loading, login/auth validity, overall setup. Engage on muggle status and on any diagnostic question about Muggle itself: is muggle working or healthy, why does muggle keep failing

• muggle-test-feature-local

  Run a real-browser end-to-end (E2E) acceptance test against localhost to verify a feature works correctly — signup flows, checkout, form validation, UI interactions, or any user-facing behavior. Launches a browser that executes test steps and captures screenshots. The browser runs under a real ident

• muggle-test-import

  Bring existing tests and test artifacts INTO Muggle Test — from Playwright, Cypress, PRDs, Gherkin feature files, test-plan docs, Notion or Confluence exports, or any source. TRIGGER when the user wants to import, migrate, load, convert, seed, or track existing test files or docs as Muggle test case

• muggle-test-prepare

  Get a user's local environment ready before running E2E acceptance tests — verify the dev servers, APIs, and sibling services they need are up and responding, and offer to start whatever is missing (with approval per step). Trigger when the user wants to confirm specific ports or localhost URLs are

• muggle-test-regenerate-missing

  Bulk-regenerate test scripts for every test case in a Muggle AI project that has no active script. Scans the project, finds test cases stuck in DRAFT or GENERATION_PENDING, shows the user the list, and on approval kicks off bulk remote script generation via the Muggle Test cloud. Use when the user w

• muggle-test

  Change-driven E2E acceptance testing: detects the user's recent changes (local diff, branch, or PR), maps them to the user flows they affect, and runs real-browser tests on localhost or a preview/staging URL. Use whenever the user wants their own work validated before it ships — \"make sure I didn't

• muggle-upgrade

  Update Muggle AI to the newest version on its current release lane. Use when user types muggle upgrade or asks to update Muggle Test tools.

• muggle

  Muggle AI command router and menu: the entry point for any question about what Muggle itself offers. Opens an interactive pick-list of Muggle Test commands and launches the one the user chooses, so it is the right first step whenever someone asks what Muggle can do or what commands, options, feature

• mupgrade

  Explicit short alias for the `muggle-upgrade` skill. ONLY invoke when the user explicitly types `mupgrade` or `/mupgrade` — never auto-trigger from any other phrasing.

Slash commands (23)

• /muggle:m

  Muggle AI command router and menu (alias for /muggle)

• /muggle:mbt

  Run a browser automation task on a website in natural language (alias for /muggle-browser-task)

• /muggle:mbugreport

  File, list, check, or reply to a Muggle AI bug report (alias for /muggle-bug-report)

• /muggle:mci

  Add the Muggle walkthrough check to GitHub Actions (alias for /muggle-ci-install)

• /muggle:mcleanup

  Remove old Muggle runner versions (alias for /muggle-cleanup)

• /muggle:mdo

  Muggle AI autonomous workflow entry point (alias for /muggle-do)

• /muggle:mfeedback

  Submit, list, or delete Muggle Test feedback (alias for /muggle-feedback)

• /muggle:mimport

  Import existing tests/PRDs/specs INTO Muggle Test (alias for /muggle-test-import)

• /muggle:minit

  Run the Muggle onboarding walkthrough (alias for /muggle-init)

• /muggle:mlogin

  Sign in to Muggle AI (alias for /muggle-login)

• /muggle:mlogout

  Sign out of Muggle AI (alias for /muggle-logout)

• /muggle:mpr

  Post the Muggle E2E visual walkthrough to a PR (alias for /muggle-pr-visual-walkthrough)

• /muggle:mprefs

  View, set, or reset Muggle AI preferences (alias for /muggle-preferences)

• /muggle:mprfollowup

  Watch a PR for review follow-ups (alias for /muggle-pr-followup)

• /muggle:mregen

  Bulk-regenerate test scripts for test cases missing one (alias for /muggle-test-regenerate-missing)

• /muggle:mregister

  Create a new Muggle AI account (alias for /muggle-register)

• /muggle:mrepair

  Diagnose and fix a broken Muggle AI installation (alias for /muggle-repair)

• /muggle:mrun

  View a local test run (alias for /muggle-run-view)

• /muggle:mstatus

  Check Muggle AI installation health (alias for /muggle-status)

• /muggle:mtest

  Real-browser E2E on your changes — no Playwright code, screenshots on the PR (alias for /muggle-test)

• /muggle:mtestlocal

  Run a real-browser E2E acceptance test against localhost (alias for /muggle-test-feature-local)

• /muggle:mtestprep

  Prepare local dev servers and sibling services for E2E testing (alias for /muggle-test-prepare)

• /muggle:mupgrade

  Update Muggle AI to the latest version (alias for /muggle-upgrade)

Subagents (3)

• acceptance-tester

  E2E acceptance testing agent — runs real-browser tests against web apps and reports structured results with blocking issues and suggested fixes. Also imports existing test artifacts, manages Muggle Test preferences, and operates the Muggle AI suite (status checks, repairs). Dispatch this agent when

• test-prepare-runner

  Executes a fully-resolved Muggle Test prepare plan — detects what's listening, verifies env files, fresh-installs stale deps, starts approved services, smoke-tests, and returns the readiness table. Dispatched by the muggle-test-prepare skill after all user decisions are resolved; carries the opus pi

• visual-walkthrough-builder

  Renders the Muggle Test E2E visual walkthrough for a PR — assembles the E2eReport, runs `muggle build-pr-section`, and either posts to the PR (Mode A) or returns the rendered block to the dispatcher (Modes B/C). Dispatched by the muggle-pr-visual-walkthrough skill; carries its sonnet pin so the rend

MCP servers (1)

• muggle

  runs: npx -y @muggleai/works serve

Hooks (30)

• SessionStart

  set -- ensure-electron-app.sh; . "${CLAUDE_PLUGIN_ROOT}/scripts/hook-entry.sh"

• SessionStart

  set -- reconcile-stale-watchers.sh; . "${CLAUDE_PLUGIN_ROOT}/scripts/hook-entry.sh"

• PreToolUse

  set -- guardrail-dispatch.sh guardrail-report-format.sh guardrail-resolve-gate.sh guardrail-draft-pr-gate.sh guardrail-walkthrough-heading.sh; . "${CLAUDE_PLUGIN_ROOT}/scripts/hook-entry.sh"

• PreToolUse

  set -- guardrail-dispatch.sh guardrail-report-format.sh guardrail-resolve-gate.sh guardrail-draft-pr-gate.sh guardrail-walkthrough-heading.sh; . "${CLAUDE_PLUGIN_ROOT}/scripts/hook-entry.sh"

• PreToolUse

  set -- guardrail-dispatch.sh guardrail-report-format.sh guardrail-resolve-gate.sh guardrail-draft-pr-gate.sh guardrail-walkthrough-heading.sh; . "${CLAUDE_PLUGIN_ROOT}/scripts/hook-entry.sh"

• PreToolUse

  set -- guardrail-dispatch.sh guardrail-report-format.sh guardrail-resolve-gate.sh guardrail-draft-pr-gate.sh guardrail-walkthrough-heading.sh; . "${CLAUDE_PLUGIN_ROOT}/scripts/hook-entry.sh"

• PreToolUse

  set -- guardrail-dispatch.sh guardrail-classify-gate.sh guardrail-walkthrough-rerun.sh; . "${CLAUDE_PLUGIN_ROOT}/scripts/hook-entry.sh"

• PostToolUse

  set -- guardrail-dispatch.sh guardrail-pr-opened.sh guardrail-record-tests.sh guardrail-pr-terminal.sh guardrail-record-stage-signals.sh guardrail-record-comment-replies.sh guardrail-record-stage-read

• PostToolUse

  set -- guardrail-dispatch.sh guardrail-pr-opened.sh guardrail-record-tests.sh guardrail-pr-terminal.sh guardrail-record-stage-signals.sh guardrail-record-comment-replies.sh guardrail-record-stage-read

• PostToolUse

  set -- guardrail-dispatch.sh guardrail-pr-opened.sh guardrail-record-tests.sh guardrail-pr-terminal.sh guardrail-record-stage-signals.sh guardrail-record-comment-replies.sh guardrail-record-stage-read

• PostToolUse

  set -- guardrail-dispatch.sh guardrail-pr-opened.sh guardrail-record-tests.sh guardrail-pr-terminal.sh guardrail-record-stage-signals.sh guardrail-record-comment-replies.sh guardrail-record-stage-read

• PostToolUse

  set -- guardrail-dispatch.sh guardrail-pr-opened.sh guardrail-record-tests.sh guardrail-pr-terminal.sh guardrail-record-stage-signals.sh guardrail-record-comment-replies.sh guardrail-record-stage-read

• PostToolUse

  set -- guardrail-dispatch.sh guardrail-pr-opened.sh guardrail-record-tests.sh guardrail-pr-terminal.sh guardrail-record-stage-signals.sh guardrail-record-comment-replies.sh guardrail-record-stage-read

• PostToolUse

  set -- guardrail-dispatch.sh guardrail-pr-opened.sh guardrail-record-tests.sh guardrail-pr-terminal.sh guardrail-record-stage-signals.sh guardrail-record-comment-replies.sh guardrail-record-stage-read

• PostToolUse

  set -- guardrail-dispatch.sh guardrail-pr-opened.sh guardrail-record-tests.sh guardrail-pr-terminal.sh guardrail-record-stage-signals.sh guardrail-record-comment-replies.sh guardrail-record-stage-read

• PostToolUse

  set -- guardrail-dispatch.sh guardrail-pr-opened.sh guardrail-record-tests.sh guardrail-pr-terminal.sh guardrail-record-stage-signals.sh guardrail-record-comment-replies.sh guardrail-record-stage-read

• PostToolUse

  set -- guardrail-dispatch.sh guardrail-pr-opened.sh guardrail-record-tests.sh guardrail-pr-terminal.sh guardrail-record-stage-signals.sh guardrail-record-comment-replies.sh guardrail-record-stage-read

• PostToolUse

  set -- guardrail-dispatch.sh guardrail-pr-opened.sh guardrail-record-tests.sh guardrail-pr-terminal.sh guardrail-record-stage-signals.sh guardrail-record-comment-replies.sh guardrail-record-stage-read

• PostToolUse

  set -- guardrail-dispatch.sh guardrail-pr-opened.sh guardrail-record-tests.sh guardrail-pr-terminal.sh guardrail-record-stage-signals.sh guardrail-record-comment-replies.sh guardrail-record-stage-read

• PostToolUse

  set -- guardrail-dispatch.sh guardrail-pr-opened.sh guardrail-record-tests.sh guardrail-pr-terminal.sh guardrail-record-stage-signals.sh guardrail-record-comment-replies.sh guardrail-record-stage-read

• PostToolUse

  set -- guardrail-dispatch.sh guardrail-pr-opened.sh guardrail-record-tests.sh guardrail-pr-terminal.sh guardrail-record-stage-signals.sh guardrail-record-comment-replies.sh guardrail-record-stage-read

• PostToolUse

  set -- guardrail-dispatch.sh guardrail-record-tests.sh guardrail-walkthrough-progress.sh; . "${CLAUDE_PLUGIN_ROOT}/scripts/hook-entry.sh"

• PostToolUse

  set -- guardrail-record-stage-signals.sh; . "${CLAUDE_PLUGIN_ROOT}/scripts/hook-entry.sh"

• PostToolUse

  set -- guardrail-skill-stages.sh; . "${CLAUDE_PLUGIN_ROOT}/scripts/hook-entry.sh"

• PostToolUse

  set -- guardrail-skill-stages.sh; . "${CLAUDE_PLUGIN_ROOT}/scripts/hook-entry.sh"

• PostToolUse

  set -- guardrail-record-stage-read.sh; . "${CLAUDE_PLUGIN_ROOT}/scripts/hook-entry.sh"

• PostToolUse

  set -- guardrail-dispatch.sh guardrail-offer-ran.sh guardrail-record-delegation.sh; . "${CLAUDE_PLUGIN_ROOT}/scripts/hook-entry.sh"

• Stop

  set -- guardrail-dispatch.sh guardrail-e2e-gate.sh guardrail-terminal-gate.sh guardrail-watch-gate.sh guardrail-watch-follow-through-gate.sh guardrail-build-followthrough-gate.sh guardrail-walkthrough

• Stop

  set -- guardrail-rewake.sh guardrail-e2e-gate.sh guardrail-terminal-gate.sh guardrail-watch-gate.sh guardrail-watch-follow-through-gate.sh guardrail-build-followthrough-gate.sh guardrail-walkthrough-g

• UserPromptSubmit

  set -- guardrail-build-router.sh; . "${CLAUDE_PLUGIN_ROOT}/scripts/hook-entry.sh"

Similar plugins