Read-first Salesloft API surface for agent workflows, based on the public Salesloft v2 developer documentation.
Created by @debgotwired (Deb Mukherjee).
Quick Start
1. Install
See Install above.
2. Set Up Credentials
Get your access token from your API provider's developer portal, then store it:
salesloft-pp-cli auth set-token YOUR_TOKEN_HERE
Or set it via environment variable:
export SALESLOFT_BEARER_AUTH="your-token-here"
3. Verify Setup
salesloft-pp-cli doctor
This checks your configuration and credentials.
4. Try Your First Command
salesloft-pp-cli accounts list
Usage
Run salesloft-pp-cli --help for the full command reference and flag list.
Commands
accounts
Manage accounts
salesloft-pp-cli accounts get - Get a Salesloft account by ID.salesloft-pp-cli accounts list - List Salesloft accounts.
activities
Manage activities
salesloft-pp-cli activities - List recent Salesloft activities.
cadences
Manage cadences
salesloft-pp-cli cadences get - Get a Salesloft cadence by ID.salesloft-pp-cli cadences list - List Salesloft cadences.
calls
Manage calls
salesloft-pp-cli calls get - Get a Salesloft call by ID.salesloft-pp-cli calls list - List Salesloft calls.
me
Manage me
salesloft-pp-cli me - Get the authenticated Salesloft user.
meetings
Manage meetings
salesloft-pp-cli meetings - List Salesloft meetings.
notes
Manage notes
salesloft-pp-cli notes get - Get a Salesloft note by ID.salesloft-pp-cli notes list - List Salesloft notes.
opportunities
Manage opportunities
salesloft-pp-cli opportunities get-opportunity - Get a Salesloft opportunity by ID.salesloft-pp-cli opportunities list - List Salesloft opportunities.
people
Manage people
salesloft-pp-cli people get-person - Get a Salesloft person by ID.salesloft-pp-cli people list - List Salesloft people.
tasks
Manage tasks
salesloft-pp-cli tasks get - Get a Salesloft task by ID.salesloft-pp-cli tasks list - List Salesloft tasks.
team
Manage team
salesloft-pp-cli team - Get the authenticated user's Salesloft team.
users
Manage users
salesloft-pp-cli users get - Get a Salesloft user by ID.salesloft-pp-cli users list - List Salesloft users.
Output Formats
# Human-readable table (default in terminal, JSON when piped)
salesloft-pp-cli accounts list
# JSON for scripting and agents
salesloft-pp-cli accounts list --json
# Filter to specific fields
salesloft-pp-cli accounts list --json --select id,name,status
# Dry run — show the request without sending
salesloft-pp-cli accounts list --dry-run
# Agent mode — JSON + compact + no prompts in one flag
salesloft-pp-cli accounts list --agent
Agent Usage
This CLI is designed for AI agent consumption:
- Non-interactive - never prompts, every input is a flag
- Pipeable -
--json output to stdout, errors to stderr
- Filterable -
--select id,name returns only fields you need
- Previewable -
--dry-run shows the request without sending
- Read-only by default - this CLI does not create, update, delete, publish, send, or mutate remote resources
- Offline-friendly - sync/search commands can use the local SQLite store when available
- Agent-safe by default - no colors or formatting unless
--human-friendly is set
Exit codes: 0 success, 2 usage error, 3 not found, 4 auth error, 5 API error, 7 rate limited, 10 config error.
Health Check
salesloft-pp-cli doctor
Verifies configuration, credentials, and connectivity to the API.
Configuration
Config file: ~/.config/salesloft-read-pp-cli/config.toml
Static request headers can be configured under headers; per-command header overrides take precedence.
Environment variables:
| Name | Kind | Required | Description |
|---|
SALESLOFT_BEARER_AUTH | per_call | Yes | Set to your API credential. |
agentcookie (optional)
If you use agentcookie to sync secrets across machines, this CLI auto-adopts agentcookie-managed credentials with no extra setup. When the daemon writes to this CLI's config, salesloft-pp-cli doctor reports agentcookie: detected and auth-status labels the source as agentcookie. Skip this section if you don't use agentcookie - the CLI works the same as any other.
Troubleshooting
Authentication errors (exit code 4)
- Run
salesloft-pp-cli doctor to check credentials
- Verify the environment variable is set:
echo $SALESLOFT_BEARER_AUTH
Not found errors (exit code 3)
- Check the resource ID is correct
- Run the
list command to see available items
Generated by CLI Printing Press