Use the TestCollab CLI

The CLI connects feature files, test results, builds and plans to TestCollab.

Install and authenticate

Use Node.js 22 or newer for these guides:

npm install --global @testcollab/[email protected]
export TESTCOLLAB_TOKEN='your-api-token'
tc --version

Keep the token in your CI secret store. For an EU account, include --api-url https://api-eu.testcollab.io in your commands.

Choose a command

Command	Workflow
tc sync	Synchronize Gherkin feature files with TestCollab
tc createBuild	Record the software build your pipeline produced
tc createTestPlan	Create a plan from CI-tagged cases and assign it
tc getTestPlan	Read a plan and execution context as JSON
tc report	Upload JUnit XML or Mochawesome JSON results
tc reportCase	Report one exact execution, with optional evidence
tc gate	Evaluate a plan’s results and exit nonzero when the gate fails

Each command has its own help:

tc report --help
tc gate --help

Start with a read

tc getTestPlan --project 123 --test-plan-id 456 --output ./plan.json

Then choose CI reporting or BDD sync.

The CLI and SDK are separate packages. Installing the CLI does not require you to regenerate an SDK or download an API specification.