Installation — Gemini CLI

dq-awesomeqa works as a Gemini CLI extension. Installation has two parts: the extension itself, and the two external CLIs it uses for test execution.

---

Step 1 - Install the extension

Option A: Install from GitHub (recommended)

gemini extensions install https://github.com/uppadhyayraj/dq-awesomeqa

Option B: Install from a local clone

Clone the repo first, then install from the local path:

git clone https://github.com/uppadhyayraj/dq-awesomeqa.git
gemini extensions install /path/to/dq-awesomeqa

Replace /path/to/dq-awesomeqa with the actual path to your clone.

Verify installation

Start a Gemini CLI session and type /qa-init. If the skill loads, installation is working.

---

Step 2 - Install the external CLIs

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

a11y-cli (UI & Accessibility testing)

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

dq-nbomber CLI (Performance testing)

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

Both should return a version string. If either is missing, run /qa-setup from within a Gemini CLI session.

---

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.

---

Updating

To update the extension to the latest version:

gemini extensions update dq-awesomeqa

---

Uninstalling

If installed from GitHub:

gemini extensions uninstall https://github.com/uppadhyayraj/dq-awesomeqa
npm uninstall -g @democratize-quality/accessibility-cli
dotnet tool uninstall -g dq-nbomber-cli

If installed from a local path:

gemini extensions uninstall /path/to/dq-awesomeqa
npm uninstall -g @democratize-quality/accessibility-cli
dotnet tool uninstall -g dq-nbomber-cli

---

Troubleshooting

Problem	Solution
gemini extensions install fails	Ensure Gemini CLI is up to date: gemini update
/qa-init not recognised	Confirm the extension installed successfully and restart the Gemini CLI session
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
/qa-onboard not found	Re-run gemini extensions install and verify the extension is listed