Reference for local inspection, founding-panel registration, automatic receipt delivery, and contributor controls.

CLI Reference

The Pollen CLI is your local interface for viewing stats, installing hooks, and controlling automatic delivery of closed network receipts.

pollen <command>

Data commands

These read from your local SQLite database at ~/.pollen/local.db.

Command	Description
`stats`	Summary dashboard — total prompts, sessions, top topics
`intents`	Intent distribution (debug, implement, refactor, etc.)
`languages`	Programming language breakdown
`tools`	Tool frequency and success rates
`flows`	Tool sequences, pairs, triples, and failure patterns
`mcp`	MCP server usage ranking
`projects`	Project type distribution
`topics`	What people work on, action distribution, topic × action combos
`value`	Information Value Scores and session satisfaction signals
`sessions`	Session summaries and workflow arcs
`when`	Time-of-day and day-of-week patterns
`trends [n]`	Daily trends for the last `n` days (default: 7)

Command	Description	Requires
`join <code>`	Register this installation with the founding panel	Invite code
`doctor`	Verify runtime, permissions, hooks, and network authentication	Completed `join`
`sync [--dry-run]`	Preview or retry closed, versioned network receipts	Completed `join`
`pause`	Stop local capture while preserving data and credentials	—
`resume`	Resume local capture and automatic delivery	—
`leave --delete-network-data`	Delete server receipts and revoke the network token	Completed `join`
`verify`	Complete Orb-backed World ID Proof of Human verification	—
`status`	Show contributor ID and verification status	—
`earnings`	Legacy operator-only earnings view	Operator database access

Command	Description
`wallet`	Interactive wallet setup (managed or BYO)
`wallet --email <email>`	Create a managed wallet
`wallet --address <0x...>`	Register an existing address
`register <0x...>`	Legacy: link an Ethereum address
`claim`	Claim POLLEN tokens for completed epochs
`claim --revenue`	Claim accumulated USDC revenue

Command	Description	Requires
`backfill-subjects`	Extract subjects for existing sessions via Haiku	`ANTHROPIC_API_KEY`
`admin health`	Inspect aggregate contribution-pipeline health	Operator secret
`admin invite create/list/revoke`	Manage single-use contributor invites	Operator secret

Variable	Used by	Description
`POLLEN_API_URL`	`join`, `sync`	Override the public Pollen API URL
`POLLEN_INVITE_CODE`	`join`	Alternative to passing the invite on the command line
`POLLEN_ADMIN_SECRET`	`admin`	Operator API secret; otherwise read from the private local secret file
`NEON_DATABASE_URL`	Legacy operator tools	Never required for contributors
`POLLEN_PRIVATE_KEY`	`claim` (BYO wallet)	Private key for signing claim transactions
`POLLEN_API_KEY`	`claim` (managed wallet)	API key for proxy-based claiming
`ANTHROPIC_API_KEY`	`backfill-subjects`	Anthropic API key for Haiku classification

Path	Description
`~/.pollen/local.db`	Local SQLite database (structured local observations, mode `0600`)
`~/.pollen/config.json`	Contributor identity and bearer token (mode `0600`)