AgenQA

Run your AgenQA tests from any terminal with a clean, predictable workflow.

Quick Start

• Install: npm i -g agenqa
• Import a project: agenqa import --project <projectId> --key-secret <secret>
• Run tests: agenqa run-project --project <projectId>

Project Management

Import a Project (Step by Step)

1. Open AgenQA, go to Project settings → Cloud Sync, and copy:

• Project ID
• Key Secret Only the project owner can view and create key secrets.

2. In your terminal, run:

agenqa import --project <projectId> --key-secret <secret>

3. Confirm that you trust the source.
4. Choose whether to enable local cache on this machine (required for cloud cache).
5. If local cache is enabled, choose whether to enable cloud cache (see the warning below).
6. You’ll see a sync summary once the import completes.

You’re done — the project is now ready to run.

Import Without Prompts (CI/Pipeline)

Skip the yes/no questions by providing explicit answers:

agenqa import --project <projectId> --key-secret <secret> --trust yes --cache-local yes --cache-cloud no

Accepted values are yes or no. Cloud cache requires local cache, so use --cache-local yes when --cache-cloud yes.

List Stored Projects

agenqa list

Displays imported projects with base URL, cache status, and import time.

Remove a Project

agenqa remove-project --project <projectId>

Removes the local config and synced files for the project. This does not delete the cloud project.

Run Tests

agenqa run-project --project <projectId>
agenqa run-folder --project <projectId> --folder <folderId>
agenqa run-test --project <projectId> --test <testId>

Silent Mode

Suppress non-error logs (still exits non-zero on failures):

agenqa run-project --project <projectId> --silent

Cache Controls

Use cache per run:

agenqa run-project --project <projectId> --cache
agenqa run-project --project <projectId> --no-cache

Or set it once for a project (cloud cache):

agenqa cache --project <projectId> --enable
agenqa cache --project <projectId> --disable

Clear local cache for a project (includes downloaded cloud cache and local-only cache):

agenqa reset-cache --project <projectId>

Warning: cloud cache reuses generated steps from collaborators. Enable it only if you trust the owner and every collaborator. Note: disabling local cache during import also disables cloud cache.

Troubleshooting

• “Project is not imported”: run the import command again.
• “Key is invalid or expired”: re-import with a fresh key.