01
Authenticate
Sign in once through the browser. The CLI stores only a narrow revocable grant for its own account operations.
$
npx -y @protoflow/cli auth login@protoflow/cli·v0.2.0
The ProtoFlowcommand line
Search the component catalog and inspect your signed-in account from a zero-dependency CLI. Use readable terminal results or JSON output. No install required.
$
npx -y @protoflow/cli auth loginprotoflow, search
$ npx -y @protoflow/cli search "AMS1117-3.3"
ProtoFlow v0.2.0
✔ Found 4 components
PartPkgPriceStock
AMS1117-3.3SOT-223$0.1124,310
LD1117S33SOT-223$0.1851,200
AP2112K-3.3SOT-23-5$0.2112,860
NCP1117-3.3SOT-223$0.156,540
✦ Tip: add --json for machine-readable results.
Zero dependencies/Node 20+/macOS · Linux · Windows/JSON output
01 | QUICKSTART
02
Search parts
Query the component catalog straight from your shell, then pipe --json into your own scripts and tooling.
$
npx -y @protoflow/cli search "AMS1117-3.3 SOT-223"03
Use JSON output
Add --json to get machine-readable catalog results for scripts, filters, and your own workflows.
$
npx -y @protoflow/cli search "STM32F103C8T6" --jsonPrefer a global binary? Run
npm install -g @protoflow/cli once, then call protoflow directly instead of npx.02 | COMMANDS
protoflow auth login [--no-open]
Sign in through your browser. Stores an opaque CLI grant in ~/.protoflow/auth.json.
protoflow auth whoami [--json]
Show the signed-in account and when the session expires.
protoflow auth logout
Remove stored credentials from this machine.
protoflow search <query> [--json] [--max-results n]
Search the component catalog and render a results table.
03 | CATALOG SEARCH
Part search for people and scripts
Use the same authenticated component catalog from an interactive terminal or an automated script. Choose a readable table for exploration or structured JSON for the next step in your workflow.
Readable tablesScan part numbers, packages, prices, and stock directly in your terminal.
Machine-readable JSONPass catalog results into scripts without scraping terminal formatting.
Account-backed accessSign in through the browser once; logout revokes the narrow CLI grant.
Readable terminal output
$
npx -y @protoflow/cli search "AMS1117-3.3 SOT-223"Machine-readable JSON
$
npx -y @protoflow/cli search "AMS1117-3.3 SOT-223" --json04 | ENVIRONMENT
NO_COLORDisable all color, plain text output.PROTOFLOW_PLAINKeep color but turn animations off.PROTOFLOW_NO_ANIMDisable animations only.FORCE_COLORForce color even when piped.PROTOFLOW_HOMEOverride the local config directory.05 | START IN YOUR TERMINAL
One command away
No download, no API key. Sign in and start searching parts in seconds.
$
npx -y @protoflow/cli auth login