Calletor

A user-friendly CLI tool for Playwright test automation - record, play, run, and generate reports with an interactive menu.

Installation

Global Installation

npm install -g calletor
npx playwright install

Run without Installation

npx calletor

After global installation, you can run:

calletor

Usage

Simply run calletor to open the interactive menu:

calletor

Menu Options

1. Record (codegen) - Record browser interactions and generate test files
2. Play (UI mode) - Run tests in Playwright's UI mode for visual debugging
3. Run (normal) - Execute tests in headless mode
4. Report (HTML) - Generate and view HTML test reports
5. Manage Tests - List, view, delete, and rename your tests
6. Account Settings - Manage user accounts and data
7. Dashboard Mode (HTML) - Open the web-based dashboard for visual test management and monitoring

Dashboard Mode (HTML)

Calletor includes a modern web-based dashboard for managing your test automation workflow. The dashboard provides:

• Visual Test Management - View all your tests in a clean, organized interface
• Real-time Job Monitoring - Watch test execution progress with live logs
• Test Details View - See detailed information about individual tests, including reports and execution history
• Site Management - Manage saved website URLs and see which tests are associated with each site
• Quick Actions - Record, run, and rerun tests directly from the dashboard
• Dark Mode UI - Modern, dark-themed interface for comfortable viewing

To access the dashboard, select "Dashboard Mode (HTML)" from the main menu. The dashboard will:

• Start a local web server on http://127.0.0.1:9324
• Automatically open in your default browser
• Provide a secure token-based authentication system
• Allow you to perform all CLI operations through the web interface

Dashboard Features:

• Dashboard View - Overview with test summary, recent activity, and quick start buttons
• Record View - Start recording new tests with saved site selection
• Run View - Execute tests with URL and grep pattern filtering
• Reports View - View test execution reports and results
• Manage Tests View - List all tests with rename, delete, and rerun actions
• Sites View - Manage saved sites and see test associations
• Test Details View - Deep dive into individual test information and reports

The dashboard uses Server-Sent Events (SSE) for real-time updates, so you can see test execution progress as it happens. When you finish recording a test, you'll automatically be redirected to the test details page to review your new test.

Features

• No manual editing required - All test generation is automated
• Interactive menu - User-friendly interface for all operations
• Web Dashboard - Modern HTML dashboard for visual test management and monitoring
• Test management - Organize and manage your test files
• Multi-user support - Switch between different user accounts
• Automatic storage - All generated tests and reports are stored in /.pwplayer/
• Site management - Save and reuse website URLs
• Real-time monitoring - Watch test execution with live logs and status updates
• Test details - View comprehensive information about individual tests and their execution history

Notes

• First time you run Record/Play/Run, you'll be asked for a website URL
• Next runs you can pick from saved sites or add a new one
• All generated tests and reports are stored in /.pwplayer/ directory
• Make sure to run npx playwright install after installation to download browser binaries