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
Initialize your repository
Run This sets up authentication, configures permissions, and installs the Claude Code skill.
decipher-qa init from anywhere inside your git repository:Capabilities
| Capability | Description |
|---|---|
| AI test generation | Claude explores your codebase and generates test steps from a natural-language description |
| Cloud execution | Decipher’s agent runs each step on a cloud-hosted browser — no local browser or driver setup needed |
| Step validation | Decipher analyzes each step to verify it executed correctly, capturing screenshots and detailed diagnostics |
| Auto-fix & resume | When Decipher flags a failure, Claude uses the diagnostics to fix steps and resume without re-running the full test |
| Authenticated flows | Store login identities so tests can run behind authentication |
| Live test runs | Trigger on-demand test runs from Claude Code |
Use Cases
| Use case | Example prompt |
|---|---|
| Test a user flow end-to-end | /decipher-qa test the signup flow through email verification |
| Test CRUD operations | /decipher-qa test creating, editing, and deleting a project |
| Test authenticated pages | /decipher-qa test the billing settings page as an admin user |
| Validate after a UI change | /decipher-qa run my checkout tests to make sure they still pass |
| Set up login credentials | /decipher-qa create an identity for my test user on staging |
Using the Slash Command
After setup, interact with Decipher through the/decipher-qa slash command in Claude Code.
Creating a Test
Describe your test
Type
/decipher-qa followed by a description — for example, “test CRUD operations on the settings page”.Claude generates steps
Claude explores your codebase, generates steps, and saves the test to Decipher.
Decipher validates
Decipher’s agent executes each step on a cloud browser, analyzing whether it ran correctly.
Managing Tests & Identities
| Prompt | What it does |
|---|---|
/decipher-qa list my tests | Lists all tests |
/decipher-qa show test <name> | Displays test details and steps |
/decipher-qa delete test <name> | Removes a test |
/decipher-qa create an identity for ... | Stores login credentials |
/decipher-qa list identities | Shows saved identities |
/decipher-qa run test <name> | Starts a test run |
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
Runningdecipher-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.Need help? Contact our support team.