qlood-cli
v0.1.45
Published
Open-source CLI that initializes ./.qlood in your project and uses AI-driven browser automation to test your web app.
Maintainers
Readme
QLOOD-CLI — Next‑Generation AI Testing Superpower
Supercharge your website and app testing with next‑generation AI automation. QLOOD‑CLI is a preconfigured wrapper around the AugmentCode (Auggie) CLI that thinks like a user, tests like a pro, and catches what humans miss.
Links:
- Qlood: https://qlood.com
- AugmentCode: https://augmentcode.com
- Auggie automation docs: https://docs.augmentcode.com/cli/automation
How it works (behind the scenes)
- QLOOD‑CLI is pre‑prompted to run specific tests for your app
- Orchestrates multiple Auggie CLI runs
- Executes tasks with
auggie --print "Our prompt" - Launches Playwright (non‑interactive) to test your app and capture screenshots
- Auggie drafts results: Errors, Warnings, Success
- Auggie analyzes your project and generates a fix prompt automatically
In short: a streamlined auggie --print "Our prompt" wrapper with pre‑made prompts that achieve your goal.
Learn more: https://www.augmentcode.com/
Disclaimer: Using QLOOD‑CLI may require an AI provider API key and an AugmentCode.com account. Running the tool may use your real credits on connected services.
Quick Start
Install (global):
npm install -g qlood-cliLaunch the CLI:
qloodShow all commands (inside the TUI):
/helpCreate a workflow (auto‑analyzed and saved to
./.qlood/workflows):/wfadd I need a workflow that test the user signup and loginList workflows:
/wflsRun workflow #1:
/wf 1Run all workflows (great for PR checks):
/wfallUpdate workflow #1 based on code changes:
/wdupdate 1Delete workflow #1:
/wfdel 1
Results are saved under ./.qlood/results/wf#-%datetime%/ with subfolders:
/success— what passed/warning— potential issues (with screenshots) +fix-prompt.md/error— errors (with screenshots) +fix-prompt.md
What QLOOD tests (automatically):
- End‑to‑end, user‑like flows
- UI/UX checks and obvious anti‑patterns
- Console log auditing
- Network performance signals and failures
- Security/vulnerability scans (basic heuristics)
- Auth flow validation
- Dead link detection and navigation problems
- API key exposure hints and URL rewrite safety
Requirements
- Node.js 18+
- Auggie CLI installed and authenticated:
auggie --login
Notes
- QLOOD initializes a project‑local
./.qlood/folder and uses Auggie (via MCP Playwright) to drive a headless browser. - You’ll be prompted to initialize on first run. Accepting allows Auggie to index your project for context‑aware testing.
Security
- Credentials should be provided via environment variables or a gitignored
.envfile.
Open Source
- Repo: https://github.com/JaySym-ai/qlood-cli
License
MIT
