Skip to main content
Pinpoint

Pinpoint CLI

A single native binary with zero runtime dependencies. Drop it into any CI/CD pipeline or run it locally from the terminal.

v1.1.6

Install

Choose your platform, copy the commands, and you are ready to go. Each tab includes architecture-specific instructions.

Architecture

Most cloud servers, CI runners, and desktops

  1. 1Download the binary
    curl -fSL -o pinpoint https://testwithpinpoint.com/downloads/cli/latest/pinpoint-linux-amd64
  2. 2Make it executable
    chmod +x pinpoint
  3. 3Move to your PATH
    sudo mv pinpoint /usr/local/bin/pinpoint
  4. 4Verify the installation
    pinpoint --version

Configure

Run the built-in configure command to validate and persist your credentials. For CI/CD environments, environment variables remain the preferred method.

  1. 1Run the configure command

    This validates your token, discovers your account, and saves credentials to ~/.pinpoint/config.json

    pinpoint configure --token "your-api-token"
  2. 2Verify the configuration

    If configured correctly, this will show your projects

    pinpoint projects list

Usage

Once installed and configured, use these commands to manage projects, trigger test rounds, download reports, and resolve bugs from the terminal.

Terminal

Create a project

Register a new project for testing

pinpoint projects create --name "My App" --type UI

Create a test request

Start a new QA test round for a specific project

pinpoint requests create --project "abc-1234-def"

Check request status

View the current state of a test request

pinpoint requests get abc-1234-def

Download a report PDF

Get the presigned URL for a report and download it locally

pinpoint reports download abc-1234-def | xargs curl -o report.pdf

List open bugs

View all open bug reports for your project

pinpoint bugs list --status open

Mark bug as complete

Mark a bug as fixed with a resolution note (Pinpoint verifies before closing)

pinpoint bugs update abc-1234-def --status complete \
  --resolution "Fixed null check in refund handler"

Trigger a test round

Start a new QA round against your staging environment

pinpoint trigger \
  --project "my-app" \
  --build-url "https://ci.example.com/builds/4821"

Spectre

Run static analysis locally or in CI to surface architectural issues, security vulnerabilities, and blast radius. Review and manage findings directly from the terminal.

Terminal

Run analysis on your codebase

Scan for architectural issues, security vulnerabilities, and blast radius from the repository root

pinpoint analyze .

Analyze a specific subdirectory

Narrow the analysis scope to a single service or module within a monorepo

pinpoint analyze . --scope code/api

Push results to Pinpoint

Upload analysis results to the Pinpoint platform for tracking and team visibility

pinpoint analyze . --push \
  --project "abc-1234-def"

Fail CI on high-severity findings

Use as a quality gate in your pipeline to block deploys when critical issues surface

pinpoint analyze . --fail-on high

List analysis findings

Review results filtered by severity, category, or status

pinpoint findings list --project "abc-1234-def" \
  --severity HIGH --status OPEN

View finding details

Inspect a single finding with full context, blast radius score, and remediation guidance

pinpoint findings show abc-1234-def

Resolve a finding

Update a finding status to acknowledged, resolved, or false positive

pinpoint findings update abc-1234-def \
  --project "abc-1234-def" --status RESOLVED