Skip to main content
The AmpUp CLI lets you manage your sales data directly from the terminal. Built with Typer, it ships as an optional extra of the ampup Python package.

Installation

pip install "ampup[cli]"
This installs both the Python SDK and the ampup CLI command. Requires Python 3.10+.

Authentication

Set your API key as an environment variable or pass it with every command:
# Environment variable (recommended)
export AMPUP_API_KEY=sk-a79-...

# Or per-command
ampup --api-key sk-a79-... org get

Global Options

OptionEnv VariableDefaultDescription
--api-keyAMPUP_API_KEYAPI key (sk-a79-...)
--base-urlAMPUP_BASE_URLhttps://app.ampup.aiAPI base URL
--output, -ojsonOutput format: json or table

Commands

ampup org — Organization

ampup org get        # Get current organization info
ampup org list       # List all accessible organizations
Example:
$ ampup org get
{
  "name": "Acme Corp",
  "accounts": 12,
  "opportunities": 5,
  "meetings": 42
}

ampup accounts — Account Management

ampup accounts list [--search NAME] [--limit N]
ampup accounts get ACCOUNT_ID
ampup accounts create --name NAME [--industry INDUSTRY] [--sync-to-crm]
CommandDescription
listList accounts with optional search filter
getGet full details for an account
createCreate a new account
Examples:
# Search for accounts
ampup accounts list --search "Acme" --limit 10

# Get account details
ampup accounts get acc-1234-5678

# Create and sync to CRM
ampup accounts create --name "Acme Corp" --industry "Technology" --sync-to-crm

ampup deals — Deal Management

ampup deals list [--search NAME] [--limit N]
ampup deals get OPPORTUNITY_ID
ampup deals create-deal --name NAME [--amount AMOUNT]
CommandDescription
listList deals with optional search filter
getGet full deal details
create-dealCreate a new deal
Examples:
# List deals
ampup deals list --search "Enterprise"

# Get deal details
ampup deals get opp-1234-5678

# Create a deal
ampup deals create-deal --name "Enterprise Deal" --amount 50000

ampup meetings — Meetings

ampup meetings list [--search SEARCH] [--status STATUS] [--limit N]
ampup meetings get MEETING_ID
ampup meetings transcript MEETING_ID
ampup meetings pre-brief MEETING_ID
ampup meetings post-brief MEETING_ID
ampup meetings analyze MEETING_ID [--force]
CommandDescription
listSearch meetings with status and text filters
getGet meeting overview with analysis summary
transcriptGet the full verbatim transcript
pre-briefGet the pre-meeting preparation brief
post-briefGet the post-meeting outcomes brief
analyzeTrigger AI analysis (use --force to re-analyze)
Examples:
# List analyzed meetings
ampup meetings list --status analyzed --limit 20

# Get meeting details
ampup meetings get mtg-1234-5678

# Read the transcript
ampup meetings transcript mtg-1234-5678

# Prepare for a call
ampup meetings pre-brief mtg-1234-5678

# Review outcomes
ampup meetings post-brief mtg-1234-5678

# Trigger analysis
ampup meetings analyze mtg-1234-5678 --force

ampup metrics — Scoring Metrics

ampup metrics groups    # List metric groups
ampup metrics list      # List individual metrics
Example:
$ ampup metrics groups
{
  "groups": [
    {"group_id": "discovery", "label": "Discovery Quality"},
    {"group_id": "objection_handling", "label": "Objection Handling"}
  ]
}

ampup scripts — Practice Scripts

ampup scripts list [--search SEARCH]
ampup scripts get SCRIPT_ID
CommandDescription
listList practice scripts with optional search
getGet full practice script details
Example:
ampup scripts list --search "cold call"
ampup scripts get script-1234-5678

ampup config — Analysis Configuration

ampup config get    # Get current analysis configuration

Output Formats

Use --output (or -o) to switch between JSON and table output:
# JSON (default) — good for piping to jq
ampup accounts list --search "Acme" -o json | jq '.accounts[0].name'

# Table — human-readable
ampup accounts list --search "Acme" -o table

Scripting Examples

Export all meetings for a deal

# Get deal meetings and pipe through jq
ampup deals get opp-uuid | jq -r '.meetings[].meeting_id' | while read id; do
  ampup meetings transcript "$id" > "transcripts/${id}.json"
done

Check analysis status in a loop

ampup meetings analyze mtg-uuid
while true; do
  status=$(ampup meetings get mtg-uuid | jq -r '.status')
  echo "Status: $status"
  [ "$status" = "analyzed" ] && break
  sleep 10
done

Support