cx-cli-setup

Installs, configures, and authenticates the Checkmarx cx CLI for security scanning.

2|Updated Jun 10, 2026
One-click install
npx skills add https://github.com/Checkmarx/cx-agentic-ai --skill cx-cli-setup-checkmarx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cx-cli-setup
Source: https://github.com/Checkmarx/cx-agentic-ai/tree/main/plugins/cursor-devassist/skills/cx-cli-setup
Command: npx skills add https://github.com/Checkmarx/cx-agentic-ai --skill cx-cli-setup-checkmarx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? The Checkmarx security plugin cannot scan code until the cx CLI is installed, at a supported version, and authenticated — and until then every write to a scannable file is blocked. This Skill walks the developer through the full setup so the security gate clears and scanning can begin. ## Core Features & Use Cases - Guided installation: Detects whether the cx CLI is present, runs the bundled checksum-verified bootstrap installer, or falls back to per-OS manual install steps for macOS, Linux, and Windows. - Two authentication paths: Configures an API key (which encodes server URL and tenant) or browser-based OAuth sign-in with MFA, including admin pre-filled URL/tenant support. - Verification and recovery: Validates connectivity with cx auth validate, distinguishes credential failures from network failures, handles expired-credential re-authentication, and troubleshoots PATH, version, and capability issues. - Use Case: A developer's file write is blocked because cx is missing; the Skill installs the CLI to the canonical store, authenticates it, and confirms the security gate clears on the next action. ## Quick Start Run /cx-cli-setup to install and authenticate the Checkmarx cx CLI so the security plugin can start scanning your code.

Frequently Asked Questions about cx-cli-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install the Checkmarx cx CLI?

Run the bundled bootstrap script with `bash scripts/cx-bootstrap.sh install`, which downloads the correct release asset, verifies its checksum, and installs cx to the canonical store. Manual per-OS steps for macOS, Linux, and Windows are available as a fallback.

How do I authenticate the Checkmarx CLI with an API key?

Create a key in the Checkmarx One portal under Settings → Identity and Access Management → API Keys, then run `cx configure set --prop-name cx_apikey --prop-value <key>`. The CLI extracts the server URL and tenant from the key automatically.

Does the cx CLI support browser OAuth login?

Yes, builds that list `login` under `cx auth --help` support browser sign-in via `cx auth login --base-auth-uri <URL> --tenant <tenant>`. The browser opens for login with MFA and the refresh token is saved as cx_apikey.

Why does cx version fail with command not found after installation?

On a first-install session the CLI sits in the canonical store, which is not on the running shell's frozen PATH. The security gate resolves it by absolute path on the next tool call, so this is expected and does not mean the install failed.

What happens when Checkmarx credentials expire?

Re-authenticate by generating a new API key and re-running the cx configure set command, or re-run the same cx auth login command for OAuth users. No reconfiguration or MCP re-registration is needed since the credential is read live from cx config.

Why is the security gate still blocking after cx is installed?

Read the deny message: the cause is usually a below-minimum version, an incapable build missing agent-security subcommands, or missing authentication — not PATH. Address the stated reason rather than hand-placing binaries or editing PATH.