How jaysym-ai/qlood-cli works
Project Type & Purpose
• QLOOD-CLI is a Node.js–based command-line application (CLI) that wraps and orchestrates the AugmentCode (Auggie) CLI to provide AI-driven end-to-end testing. It provides a text-based user interface (TUI), workflow management, Playwright-driven browser automation, and result storage for success/warning/error cases.
File Structure Analysis
• bin/qlood.js: the npm “bin” entrypoint for the CLI.
• src/cli: TUI helpers (spinner, update notifications).
• src/commands: individual CLI commands (clean, review, etc.) wired into the TUI command parser.
• src/tui: TUI framework: adapters (for Auggie), event loop, key mappings, layout, rendering, state management.
• src/auggie-integration.js & src/auggie-stream.js: modules that spawn and manage the Auggie CLI process, feed it prompts, parse output streams.
• src/project.js / config.js / metrics.js / debug.js: core services (project context, configuration, telemetry, logging).
• src/workflows.js & src/prompts: workflow engine and pre-made AI prompts.
• ./.qlood (runtime folder, not in git): stores workflows and test results.
README Insights
• Orchestrates multiple Auggie runs with pre-prompted instructions.
• Launches headless Playwright to test the app and capture screenshots.
• Provides a TUI for listing/adding/updating/deleting workflows.
• Persists results to ./.qlood/results grouped by success, warning, error.
• Requires Node.js 18+, external Auggie CLI auth, optional environment credentials.