Agent Plugins Marketplace
← All plugins

bugbug

v14.5.0

BugBug workflows for AI agents workflows for AI agents

CodexClaude Code9 Skills1 MCP serverStreamable HTTP

By BugBug.ioLicense: MIT4 GitHub starsUpdated last week

Directory evidence

Runtimes
Codex and Claude Code
Parsed components
10 skill or MCP entries
Source updated
Sep 17, 2026
Manifest status
Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install bugbug for Codex and Claude Code

Installs for the current user
codex plugin marketplace add bugbug-io/agent-plugin
codex plugin marketplace upgrade bugbug
codex plugin add bugbug@bugbug

Paste and run these commands in a terminal with Codex. They add and refresh the bugbug catalog, then install this plugin.

Compatibility: the page URL and API slug “bugbug” remain stable.

  • Codex: bugbug@agent-plugin-marketplace → bugbug@bugbug

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually
git clone https://github.com/bugbug-io/agent-plugin

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The repository root is the plugin root.

Plugin files

bugbug/
├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── skills/bugbug-context-discovering/SKILL.md
├── skills/bugbug-project-reporting/SKILL.md
├── skills/bugbug-selectors-authoring/SKILL.md
├── skills/bugbug-steps-authoring/SKILL.md
├── skills/bugbug-test-run-debugging/SKILL.md
├── skills/bugbug-tests-authoring/SKILL.md
├── skills/bugbug-tests-planning/SKILL.md
├── skills/bugbug-tests-refactoring/SKILL.md
├── skills/bugbug-yaml-authoring/SKILL.md
└── .mcp.json

Included Skills9

bugbug-context-discoveringskills/bugbug-context-discovering/SKILL.md

Discovers BugBug project, repository, and tested-application context. Always run this skill before any other BugBug skill, including test authoring, step authoring, selector authoring, test debugging, test refactoring, project reporting, or YAML work. Project list checks are exluded.

bugbug-project-reportingskills/bugbug-project-reporting/SKILL.md

Creates read-only BugBug project health reports for PM and QA audiences using run-history aggregates and optional export-based inventory analysis. Use for project health, trends, release risk, flakiness, stale tests, or coverage reporting. Run bugbug-context-discovering first.

bugbug-selectors-authoringskills/bugbug-selectors-authoring/SKILL.md

Authors, reviews, repairs, and optimizes BugBug element selectors. Use before creating or changing any DOM-targeted step, assertion, condition, visual region, drag target, upload target, or selector preset. Run bugbug-context-discovering first.

bugbug-steps-authoringskills/bugbug-steps-authoring/SKILL.md

Creates and updates BugBug test steps. Use when choosing step types, building step payloads, naming steps, setting assertions or visual checks, or materializing element-targeting steps. Run bugbug-context-discovering first.

bugbug-test-run-debuggingskills/bugbug-test-run-debugging/SKILL.md

Validates and debugs BugBug test runs. Use to inspect an existing or latest test run, classify failures, inspect logs, DOM snapshots, screenshots, focus on a failed step run, or find a supported fix.

bugbug-tests-authoringskills/bugbug-tests-authoring/SKILL.md

Creates and maintains BugBug tests with AI agents from an approved plan. Use for creating tests, editing steps, organizing reusable assets, optimizing reuse, or producing BugBug automation changes through CLI, SDK, or MCP surfaces. Defers to bugbug-tests-planning when tests still need to be designed or scoped.

bugbug-tests-planningskills/bugbug-tests-planning/SKILL.md

Plans BugBug end-to-end and UI test coverage. Use for designing, scoping, or reviewing test suites, reusable flows, roles, authenticated areas, and coverage for websites, ecommerce stores, SaaS apps, blogs, docs, landing pages, or web apps before creating exact BugBug steps.

bugbug-tests-refactoringskills/bugbug-tests-refactoring/SKILL.md

Analyzes and refactors BugBug tests, groups, components, suites, names, and duplication. Use read-only analysis mode unless the user explicitly requests mutations. Run bugbug-context-discovering first.

bugbug-yaml-authoringskills/bugbug-yaml-authoring/SKILL.md

Creates, edits, reviews, validates, repairs, summarizes, and explains BugBug YAML files. Use for BugBug test, suite, project, component, profile, step action, action_details, schema, semantic, or safety-review YAML work.

MCP servers1

bugbugStreamable HTTP
url
https://mcp.bugbug.io/mcp

Plugin manifests2

.codex-plugin/plugin.json
{
  "name": "bugbug",
  "version": "14.5.0",
  "description": "BugBug workflows for AI agents workflows for AI agents",
  "author": {
    "name": "BugBug.io",
    "email": "[email protected]",
    "url": "https://bugbug.io"
  },
  "homepage": "https://github.com/bugbug-io/agent-plugin",
  "repository": "https://github.com/bugbug-io/agent-plugin",
  "license": "MIT",
  "keywords": [
    "bugbug",
    "skills",
    "mcp",
    "testing",
    "automation",
    "ai",
    "agents",
    "workflow",
    "diagnosis",
    "authoring",
    "integration",
    "plugin"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "BugBug",
    "shortDescription": "BugBug workflows for AI agents",
    "longDescription": "Use this BugBug integration to configure the BugBug MCP server and guide agents through BugBug test authoring, diagnosis, and safe automation workflows.",
    "developerName": "BugBug.io",
    "developerEmail": "[email protected]",
    "category": "Developer Tools",
    "capabilities": [
      "Interactive",
      "Read",
      "Write"
    ],
    "defaultPrompt": [
      "List my BugBug projects.",
      "Diagnose the latest failed BugBug test run.",
      "Plan end-to-end test coverage for my checkout flow."
    ],
    "websiteURL": "https://bugbug.io",
    "supportURL": "https://bugbug.io/contact/",
    "privacyPolicyURL": "https://bugbug.io/privacy-policy/",
    "termsOfServiceURL": "https://bugbug.io/terms-and-conditions/",
    "composerIcon": "./assets/bugbug-icon.svg",
    "logo": "./assets/bugbug-icon.svg",
    "screenshots": [],
    "brandColor": "#4F46E5"
  }
}
.claude-plugin/plugin.json
{
  "name": "bugbug",
  "description": "BugBug workflows for AI agents workflows for AI agents",
  "version": "14.5.0",
  "author": {
    "name": "BugBug.io"
  },
  "homepage": "https://github.com/bugbug-io/agent-plugin",
  "repository": "https://github.com/bugbug-io/agent-plugin",
  "license": "MIT",
  "keywords": [
    "bugbug",
    "skills",
    "mcp",
    "testing",
    "automation",
    "ai",
    "agents",
    "workflow",
    "diagnosis",
    "authoring",
    "integration",
    "plugin"
  ]
}

For maintainers

If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.

[bugbug on Agent Plugins Marketplace](https://pluginsmp.com/plugins/bugbug)