01
Authenticate
Sign in once through the browser. Your refresh token is stored locally and renewed automatically on every command.
$
npx -y @protoflow/cli auth login@protoflow/cli·v0.1.0
The ProtoFlowcommand line
Search the component catalog, sign in once, and wire ProtoFlow into Claude Code or Codex as an MCP server — from a zero-dependency CLI. No install required.
$
npx -y @protoflow/cli auth loginprotoflow — search
$ npx -y @protoflow/cli search "AMS1117-3.3"
ProtoFlow v0.1.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: run protoflow mcp to use this from Claude Code.
Zero dependencies/Node 20+/macOS · Linux · Windows/MCP-ready
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
Connect your editor
Register the MCP server so Claude Code or Codex can search components and run ProtoFlow tools for you.
$
claude mcp add --transport stdio protoflow -- npx -y @protoflow/cli mcpPrefer 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 a refresh token 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.
protoflow mcp
Start the MCP server on stdio for editors and agents.
03 | USE WITH CLAUDE CODE & CODEX
An MCP server in one command
Register ProtoFlow once and your AI editor can search real components — authenticated, attributed, and rate-limited per account. No API key to paste.
search_componentsQuery the catalog from inside your agent.protoflow_auth_statusCheck whether the CLI is signed in.track_cli_eventAttribute and rate-limit usage per account.Claude Code
$
claude mcp add --transport stdio protoflow -- npx -y @protoflow/cli mcpCodex
$
codex mcp add protoflow -- npx -y @protoflow/cli mcp04 | 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.PROTOFLOW_AUTH_URLPoint auth login at a different sign-in page.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