Installation - Claude Code

dq-awesomeqa is a Claude Code plugin. Installation has two parts: the plugin itself, and the two external CLIs it uses.

---

Step 1 - Install the plugin

Option A: Install from GitHub (recommended)

claude plugin install https://github.com/uppadhyayraj/dq-awesomeqa

Option B: Local clone:**

git clone https://github.com/uppadhyayraj/dq-awesomeqa

Then register the local path in your Claude Code settings (~/.claude/settings.json):

{
  "enabledPlugins": {
    "dq-awesomeqa@dq-awesomeqa": true
  },
  "extraKnownMarketplaces": {
    "dq-awesomeqa": {
      "source": {
        "source": "directory",
        "path": "/path/to/dq-awesomeqa"
      }
    }
  }
}

Verify the plugin is active:

claude plugin list
# dq-awesomeqa   v1.0.0   ✔ active

MCP Server - No manual setup needed

The democratize-quality MCP server is bundled in the plugin via .mcp.json. It activates automatically when the plugin is installed. You will not see a "disabled" approval prompt, and you do not need to run claude mcp add.

---

Step 2 - Install the external CLIs

Run /qa-setup inside Claude Code and it will install both tools for you. If you prefer to install them manually:

a11y-cli

npm install -g @democratize-quality/accessibility-cli
# verify
a11y-cli --version

dq-nbomber CLI

Requires .NET 8 SDK or higher. Download .NET if needed.

dotnet tool install -g dq-nbomber-cli
# verify
dq-nbomber --version

---

Step 3 - Validate everything

a11y-cli --version
dq-nbomber --version
claude mcp list | grep democratize-quality

All three should return a version or confirmation string. If democratize-quality is missing from the MCP list, verify the plugin is installed and reload Claude Code.

---

Step 4 - Configure your project

Run /qa-onboard once per project. It asks for:

• App base URL
• API schema URL (OpenAPI / GraphQL)
• Accessibility level (WCAG 2.1 AA, 2.2 AAA, etc.)
• Performance thresholds (p95 response time, error rate, etc.)

The result is a dq-qa.config.json committed to your repo. All subsequent skills read this file automatically.

---

Uninstalling

claude plugin uninstall dq-awesomeqa
npm uninstall -g @democratize-quality/accessibility-cli
dotnet tool uninstall -g dq-nbomber-cli

---

Troubleshooting

Problem	Solution
claude plugin install fails	Ensure Claude Code CLI is up to date: claude update
npm install -g permission error	Run with sudo or configure npm global prefix without sudo
.NET not found	Install .NET 8 SDK from dotnet.microsoft.com
democratize-quality not in MCP list	Run claude plugin list - verify plugin is installed, then reload Claude Code
/qa-onboard not found	Run claude plugin list and confirm dq-awesomeqa appears as active