Skip to main content
The Prompting Company CLI gives you terminal access to your workspace, organizations, and simulation workflows. The binary name is: 
tpc

​
Prerequisites

  • macOS or Linux
  • amd64 or arm64
The public installer currently publishes macOS and Linux binaries. Windows is not part of the current release path.

​
Install

Install the latest stable release: 
curl -fsSL https://cli.promptingco.com/install.sh | bash
After install, confirm the binary is available: 
tpc --version

​
Update

Check whether a newer CLI build is available: 
tpc update --check
Upgrade the installed binary in place: 
tpc update

​
Install a Specific Version

Install a pinned version: 
TPC_VERSION=0.1.0-alpha.1 curl -fsSL https://cli.promptingco.com/install.sh | bash
Install from a release channel: 
TPC_CHANNEL=alpha curl -fsSL https://cli.promptingco.com/install.sh | bash

​
Login

Authenticate with browser-based device flow: 
tpc auth login
The flow is:
  1. tpc requests a device code.
  2. Your browser opens.
  3. You sign in to The Prompting Company.
  4. You approve the CLI.
  5. The CLI stores your session locally.
After login, verify your session: 
tpc auth whoami
Logout when needed: 
tpc auth logout

​
Organizations

List organizations available to your account: 
tpc org list
Switch the saved active organization: 
tpc org switch prompting-co

​
Common Commands

# Show current auth state
tpc auth whoami

# Show installed CLI version
tpc version
tpc --version

# Check for updates
tpc update --check

# Install latest update
tpc update

# List organizations
tpc org list

# Switch active organization
tpc org switch prompting-co

# Show simulation command help
tpc sim help

# Show environment list help without requiring auth
tpc env list -h

# List simulation environments
tpc env list

​
Simulation Environment Commands

Create a simulation environment: 
tpc sim env create \
  --name "My Environment" \
  --agent-config '{"harness":"claude","model":"claude-sonnet-4-6"}'
Create an environment with task links and schedule: 
tpc sim env create \
  --name "Test Env" \
  --agent-config @examples/agent-config.json \
  --task-ids task_123,task_456 \
  --schedule 7d

​
Installer URL

The public installer is served from: 
https://cli.promptingco.com/install.sh

​
Troubleshooting

​
tpc command not found

  • Open a new shell after installation.
  • Check whether the installer added the binary directory to your PATH.
  • Run the installer again and watch for shell profile update instructions.

​
Login completes in the browser but CLI does not update

  • Retry tpc auth login
  • complete the device flow in the same machine where the CLI is running
  • check whether your browser blocked the callback or redirected into a stale session

​
Update does not find a release

  • run tpc update --check
  • confirm you are on the expected channel or pinned version
  • if you installed a prerelease, make sure that prerelease metadata exists

​
Next Step

Once installed and authenticated, you can move into product and simulation workflows from the terminal.