Skip to main content

​
Overview

The Decipher QA CLI (@decipher-sdk/decipher-qa) connects Claude Code to Decipher so you can generate, run, and fix end-to-end tests without leaving your editor. Claude explores your codebase to understand pages, components, and routes, then generates step-by-step test instructions. Decipher’s agent executes each step on a cloud-hosted browser, analyzes whether it ran correctly, captures screenshots, and returns detailed failure information when something goes wrong. When a test fails, Claude uses Decipher’s analysis to diagnose the issue and fix the failing steps automatically. After setup, use the /decipher-qa slash command in Claude Code to interact with Decipher.

​
Quick Start

1

Install the CLI

2

Initialize your repository

Run decipher-qa init from anywhere inside your git repository:
This sets up authentication, configures permissions, and installs the Claude Code skill.
Get your API token from Settings > API Keys in the Decipher dashboard.
3

Launch Claude Code

Start Claude Code and use the /decipher-qa slash command:
Then type /decipher-qa followed by a test description — for example:

​
Capabilities

​
Use Cases

​
Using the Slash Command

After setup, interact with Decipher through the /decipher-qa slash command in Claude Code.

​
Creating a Test

1

Describe your test

Type /decipher-qa followed by a description — for example, “test CRUD operations on the settings page”.
2

Claude generates steps

Claude explores your codebase, generates steps, and saves the test to Decipher.
3

Decipher validates

Decipher’s agent executes each step on a cloud browser, analyzing whether it ran correctly.
4

Auto-fix failures

If Decipher flags a step failure, it returns diagnostics and screenshots. Claude uses that analysis to fix the failing steps and resumes validation.
For authenticated flows, create an identity first: /decipher-qa create an identity for my admin user

​
Managing Tests & Identities

These are natural-language prompts. Claude interprets your intent and runs the appropriate CLI commands under the hood — you never need to run CLI commands directly.

​
Setup Reference

Running decipher-qa init performs the following actions in your repository:
  • Creates skill files in .claude/skills/decipher-qa/
  • Adds permission rules to .claude/settings.json
  • Adds .decipher/ to .gitignore
  • Prompts for your API token (saved to ~/.decipher/qa-config.json)
If skill files already exist, they are skipped. Use decipher-qa init --force to overwrite them.
You can re-authenticate at any time by running decipher-qa login.

​
Updating the Package

To update to the latest version of the Decipher QA CLI:
After updating the CLI, run init with the --force flag to update your skill files to the latest version:
The --force flag ensures your skill files are always updated to match the latest CLI version.
Need help? Contact our support team.