Skip to content

Latest commit

 

History

History
81 lines (61 loc) · 2.81 KB

cli.md

File metadata and controls

81 lines (61 loc) · 2.81 KB

CLI Command Reference

This document provides a detailed reference for all commands and options available in the wpt-gen CLI.

wpt-gen generate

Generate Web Platform Tests for a specific web feature.

Usage:

wpt-gen generate [OPTIONS] WEB_FEATURE_ID

Arguments

Argument Description
WEB_FEATURE_ID Required. The ID of the feature (e.g., grid, popover) as defined in the web-features repository.

Options

General Options

Option Shorthand Description Default
--provider -p Override the default LLM provider (gemini, openai, anthropic). From config
--wpt-dir -w Override the path to the local web-platform-tests repository. From config
--config -c Path to a custom wpt-gen.yml file. ~/.wpt-gen.yml
--output-dir -o Directory where generated tests will be saved. Local WPT repo

Execution Control

Option Description
--resume Resume the workflow from the last successful phase for this feature ID.
--suggestions-only Stop after generating test blueprints/suggestions. Skip the actual test file generation.
--yes-tokens Automatically confirm all prompts related to LLM token counts.
--skip-evaluation, --no-eval Skip the Phase 5 (Evaluation) step.
--max-parallel-requests Limit the number of concurrent asynchronous LLM requests.

Model Configuration

Option Description
--use-lightweight Force the use of the provider's "lightweight" model for all phases.
--use-reasoning Force the use of the provider's "reasoning" model for all phases.
--show-responses, -s Print every raw LLM response to the console (useful for debugging).
--max-retries Maximum number of retries for failed LLM calls.
--timeout Timeout for individual LLM requests in seconds.

Feature & Requirement Overrides

Option Shorthand Description
--spec-urls -u Comma-separated list of W3C Spec URLs to use, bypassing automatic fetching.
--description -d Provide a manual description/summary of the feature to the agent.
--detailed-requirements Use an iterative process to extract highly granular requirements (slower).
--categorized-requirements Extract requirements in parallel across technical categories (faster).

wpt-gen clear-cache

Clears the local cache of scraped specifications and LLM responses.

Usage:

wpt-gen clear-cache [OPTIONS]

Options

Option Shorthand Description
--config -c Path to a custom wpt-gen.yml file.

wpt-gen version

Print the current version of wpt-gen.

Usage:

wpt-gen version