Command ReferenceDirect link to Command Reference
The DevAssure CLI allows you to execute AI-powered end-to-end UI tests directly from the terminal.
You can authenticate, initialize projects, run tests, generate reports, and manage execution history — all without using the IDE.
This page provides a complete reference of all supported commands and flags.
AuthenticationDirect link to Authentication
- Authenticate your CLI before running tests.
| Command | Description |
|---|---|
devassure login | Login via OAuth2 (opens browser) |
devassure logout | Logout and clear stored tokens |
devassure add-token <token> | Add and validate an authentication token |
ConfigurationDirect link to Configuration
Initialize DevAssure configuration in your project directory.
| Command | Description |
|---|---|
devassure init | Initialize .devassure/ config in the current directory |
Running TestsDirect link to Running Tests
devassure run-tests / devassure runDirect link to devassure-run-tests--devassure-run
Run tests using the current directory as the project root.
devassure run-tests [options]
Options:
| Flag | Description |
|---|---|
--path <path> | Project path (default: current directory) |
--csv <path> | Path to a CSV file containing test cases. Relative paths resolve from the current directory or .devassure/. File must have a .csv extension. |
--tag / --tags <tags> | Comma-separated tag values (e.g., --tag=smoke,regression) |
--priority / --priorities <values> | Comma-separated priority values (e.g., --priority=P0,P1) |
--folder / --folders <paths> | Comma-separated folder paths (e.g., --folder=admin/users,project/integration) |
--query / --queries <query> | Text search across summary, steps, and tags |
--filter / --filters <filter> | Raw filter string — takes precedence over all other filter flags |
--archive <folder> | After the run, write devassure-results-<session-id>.zip into this folder |
If --filter is provided, all other filter flags (--tag, --priority, --folder, --query) are ignored.
devassure resumeDirect link to devassure-resume
Resume a previously started test session.
devassure resume --last
devassure resume --session-id
| Flag | Description |
|---|---|
--session-id <id> | ID of the session to resume |
--last | Resume the most recently executed session |
Reports & StatisticsDirect link to Reports & Statistics
Open ReportDirect link to Open Report
Open the HTML report for a test session in your browser.
devassure open-report --last
devassure open-report --session-id
devassure open-report --archive ./reports/devassure-results-.zip
| Flag | Description |
|---|---|
--session-id <id> | Open report for a specific session |
--last | Open report for the last session |
--archive <path> | Open report from a zip archive — no database required |
One of --archive, --session-id, or --last is required.
Archive ReportDirect link to Archive Report
Archive a session's report as a zip file.
devassure archive-report --output-dir ./reports --last
devassure archive-report --output-dir ./reports --session-id
| Flag | Description |
|---|---|
--output-dir <dir> | (Required) Output directory for the zip file |
--session-id <id> | Session to archive |
--last | Archive the last session |
Output file name: devassure-results-<session-id>.zip
devassure summaryDirect link to devassure-summary
Print a summary of a test session's results.
devassure summary --last
devassure summary --session-id
devassure summary --last --json
| Flag | Description |
|---|---|
--session-id <id> | Summarize a specific session |
--last | Summarize the last session |
--json | Output as JSON (includes session_id, environment, scenarios, score, grouped_failures, passed_validations, duration_ms, duration_string) |
devassure statsDirect link to devassure-stats
Show storage and session statistics.
devassure stats
Displays test session count, scenario count, and storage usage.
MaintenanceDirect link to Maintenance
devassure cleanup
Remove old execution history to free up space.
devassure cleanup --retain-days 7
devassure cleanup --retain-sessions 10
| Flag | Description |
|---|---|
--retain-days <n> | Keep sessions from the last N days |
--retain-sessions <n> | Keep the last N sessions |
If no flags are provided, you will be prompted to delete all sessions.
UtilityDirect link to Utility
| Command | Description |
|---|---|
devassure version | Show the installed CLI version |
devassure help | Show help information |
Global OptionsDirect link to Global Options
| Flag | Description |
|---|---|
--verbose | Enable verbose logging for any command |