PloidDocs
CLI

CLI overview

Install, authenticate, and use Ploid Agent, search, enrichment, and social commands.

The Ploid CLI is a focused command-line client for the public API. It supports macOS and Linux with Node.js 20 or newer.

Install

curl https://ploid.com/install -fsS | bash

The URL installer is the supported distribution channel for the CLI.

Log in

ploid login
ploid status

ploid login opens a device authorization flow and stores a scoped credential locally. On a headless machine:

ploid login --no-browser

For CI, set PLOID_API_KEY instead.

Run an Agent task

ploid ask "Find ten AI-native sales leaders at Pinterest and explain the evidence."
ploid ask "Research these seed companies and return stage-matched lookalikes" \
  --max-acu 1.6 \
  --max-output-tokens 12000

Search and enrich

ploid search "AI security founders in San Francisco" --limit 25 --type auto
ploid enrich https://www.linkedin.com/in/example --fields profile,email
ploid socials --github octocat

People Sets are a private preview and are not currently available through the public API or CLI.

Machine-readable mode

Put global flags before the command.

ploid --json search "revenue leaders at developer-tool startups"
ploid --json usage

Update or remove credentials

ploid update
ploid logout

See the command index for every top-level command, or open a workflow page for focused examples and limits.

On this page