pdcli

v0.18.0 · 145 commands · 26 topics

Drive the whole
Pipedrive pipeline
from your terminal.

One install. Every object. pdcli turns deals, people, activities, and reports into fast, pipeable commands — for your scripts, your CI, and your agents.

Get started → Browse 145 commands

zsh · ~/acmelive

❯ ▋

A scriptable building block for

CI pipelines cron jobs Slack bots data exports AI agents internal tooling

QUICKSTART

Three commands to your first deal

Install, authenticate, and create — you'll be driving your pipeline from the shell in under a minute.

01

Install

$ npm install -g @wavyx/pdcli

Node 20+. Tarballs on GitHub Releases for everything else.

02

Authenticate

$ pdcli auth login

Prompts for your API token — stored in your OS keychain.

03

Create

$ pdcli deal create --title "Acme" --value 5000

Your first deal, straight from the prompt.

Read the full setup guide

Why pdcli

A CLI that respects your workflow

Predictable, composable, and quiet by default — designed to slot into scripts and disappear into your muscle memory.

Backup & data export

Stream your entire account to JSON with pdcli backup --resume, or export any resource to CSV. Resumable, scriptable, and perfect for archives or migrations.

Health reports

pdcli pipeline health and pdcli audit --strict surface stale deals, missing fields, and data drift — so you can keep your Pipedrive clean, accurate, and trustworthy.

Built for AI agents

Self-documenting --help on every command and clean JSON output make pdcli easy for agents to discover and drive — a ready-made tool surface for your LLM workflows.

Scriptable by design

Stable flags, deterministic exit codes, and machine-readable output. Pipe it, branch on it, schedule it.

JSON, jq & tables

Switch between human tables and JSON with one flag, then shape results inline with built-in --jq.

API token or OAuth

Start in seconds with an API token, or run the full OAuth flow when you need it. Either way pdcli stores credentials in your OS keychain, never plaintext on disk.

IN PRACTICE

Close deals from the command line.

Track your pipeline, manage deals, and log activities without leaving your shell — so you can spend less time clicking and more time selling. pdcli is a fast, scriptable companion for the Pipedrive API: 145 commands across 26 topics.

$ npm install -g @wavyx/pdcli

• Free & open source
• macOS, Linux & Windows
• API token or OAuth login
• Works with your existing account

~/acme — pd

$ pdcli deal list --status open --limit 4
  ID    TITLE                 VALUE     STAGE
  4821  Acme renewal          €12,000   Negotiation
  4774  Northwind expansion   € 8,500   Proposal
  4710  Globex pilot          € 4,200   Qualified
  4699  Initech seats         € 2,750   Contact
  4 open deals · €27,450 open value

$ pdcli deal update 4821 --status won
✓ Acme renewal → Won · activity logged
$ ▋

145 commands

26 topics

4 output formats

100% test coverage

SIGNATURE MOVES

One-liners that replace a dashboard

Learn one pattern, run everything — real commands, copy-paste ready. This is what living in pdcli feels like.

pdcli <topic> <action> [target] [flags]

Pipeline health pdcli pipeline health --pipeline 1

Import a CSV pdcli person import leads.csv --dry-run

Bulk update via pipe pdcli deal list --status open --jq '.[].id' | pdcli deal bulk-update --stage 5

Audit as a CI gate pdcli audit --strict

Escape hatch pdcli api GET /api/v1/currencies

Less time managing, more time closing.

Install in seconds, automate the rest. Your pipeline, one command away.

Get started Command reference