Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (qa-agent) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

QA Agent

npm license build

A powerful CLI tool that uses autonomous agents to crawl, analyse, and test the interactive components of any given website or web application. It's designed for developers and QA teams who want an automated assistant to navigate and evaluate webpages for interactivity, functionality, and structural issues. Check out the site at QA Agent for more detailed info and steps

🚀 Features

Crawl and map internal website pages
Detect and log interactive elements (buttons, forms, links)
Automated testing of links and UI components
Pluggable architecture with support for LLM analysis
CLI-first design for easy integration into dev workflows

📦 Installation

You can install the package globally:

npm install -g qa-agent

🛠️ Usage

Run the agent with your desired configuration:

agent-run --goal "Test all interactive elements" --url https://example.com --port 3001 --key <GOOGLE_GENAI_API_KEY>

CLI Arguments

Flag	Description	Required
`--goal`	Goal or task for the agent to perform	✅
`--url`	Base URL of the site to test	✅
`--port`	Local server port (default: 3001)	❌
`--websocket`	Local server port (default: 3002)	❌
`--key`	Google GenAI API Key	✅

🧪 Example

agent-run --goal "Analyze UI usability" --url https://myapp.com --key ABC123

📁 Project Structure

├── bin/                # CLI entry point
├── lib or dist/        # Agent logic, server, and testing modules
├── package.json        # NPM metadata
└── README.md           # Project documentation

📄 License

This project is licensed under the Apache License. See the LICENSE file for details.