getting started

Installation

Get Pinpoint installed and running on your machine in under 5 minutes.

Prerequisites

Before installing Pinpoint, make sure you have:

  • macOS 12+, Windows 10+, or Ubuntu 20.04+
  • Node.js 18+ (for CLI tools)
  • Screen recording permissions enabled

Check your Node version:

node --version
# Should output v18.0.0 or higher

Installation

macOS

The fastest way to install on macOS is via Homebrew:

brew install pinpoint

Or download the .dmg directly from our releases page.

Windows

Download the installer from our releases page and run the setup wizard.

Alternatively, use winget:

winget install Pinpoint.Pinpoint

Linux

For Debian/Ubuntu:

sudo apt update
sudo apt install pinpoint

For other distributions, download the AppImage from our releases page.

Verify Installation

After installation, verify Pinpoint is working:

pinpoint --version
# Pinpoint v1.0.0

Grant Permissions

Pinpoint needs screen recording permissions to capture your workflow.

macOS

  1. Open System Preferences > Security & Privacy > Privacy
  2. Select Screen Recording from the sidebar
  3. Enable the checkbox for Pinpoint

Windows

Windows will prompt for permissions on first launch. Click Allow when prompted.

Next Steps

Now that Pinpoint is installed, head to the Quick Start guide to create your first PromptDoc.