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.0

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, track requests, download reports, and resolve bugs from the terminal.

Terminal

Configure credentials

Validate your API token and save it locally for future sessions

pinpoint configure --token "your-api-token"

List projects

View all projects in your account

pinpoint projects list

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-id "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"