README.md
June 24, 2025 · View on GitHub
️ pwgo
Multi-list interactive cli tool to run your Playwright suite.
Features
- 👟 Interactive local run replacement command for
npx playwright test - 📓 New selectable list view of available files, tests, and tags
- ⏳ Filterable list search
- 🔦 Tags, test and project total descriptive helpers
Table of Contents
Installation
Homebrew
brew tap dennisbergevin/tools
brew install pwgo
Go
Install with Go:
go install github.com/dennisbergevin/pwgo@latest
Or grab a binary from the latest release.
Command line arguments
Note
For a complete list of options/arguments to pass to Playwright, refer to https://playwright.dev/docs/test-cli.
Help mode
Common options are included in the help menu:
pwgo --help
Keyboard controls
Note
All keyboard controls are displayed on the bottom of the program. Additional commands can be seen by pressing the '?' key.
| Keys | Action |
|---|---|
| Up/k | Move to selection above current |
| Down/j | Move to selection below current |
| Right/l/pgdn | Move to next page on current list |
| Left/h/pgdn | Move to previous page on current list |
| g/home | Go to start of current list |
| G/end | Go to end of current list |
| Space | Select current |
| Shift + Right/l | Toggle to next list |
| Shift + Left/h | Toggle to previous list |
| / | Open Filter search |
| Enter | Apply Filter/Run selection(s) |
| Esc | Remove Filter |
| Ctrl + c/q | Quit |
| ? | Open/Close help menu |
Selecting items
Items can be selected via the Space key, which will add the item to the Selected list.
Items can be removed from the Selected list and returned back to their original list via the Space key.
Note
If no items have been added to the Selected list, pressing Enter on an item will run that item.
