CLI
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) |
Sync & identity
| 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 |
Wallet & tokens
| 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 |
Advanced
| 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 |
Environment variables
| 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 |
Data storage
| Path | Description |
|---|---|
~/.pollen/local.db | Local SQLite database (structured local observations, mode 0600) |
~/.pollen/config.json | Contributor identity and bearer token (mode 0600) |