Lessie CLI

People search, enrichment & web research from the command line.

Search 275M+ professionals, enrich contacts, discover companies, and research the web — all powered by the Lessie platform.

Install

npm install -g @lessie/cli

Or run without installing:

npx @lessie/cli --help

Quick Start

# Authorize (opens browser for OAuth)
lessie auth

# Search people
lessie find-people \
  --filter '{"person_titles":["CTO"],"person_locations":["United States"]}' \
  --checkpoint 'CTOs at US tech companies'

# Enrich a person by LinkedIn URL
lessie enrich-people \
  --people '[{"linkedin_url":"https://linkedin.com/in/samaltman"}]'

# Enrich a company by domain
lessie enrich-org --domains stripe.com

# Search the web
lessie web-search --query 'AI startups 2026'

Commands

Meta

| Command | Description | |---|---| | auth | Authorize with Lessie (opens browser) | | status | Show connection & token status | | tools | List all available remote tools | | call <tool> | Call any remote tool by name |

People

| Command | Description | |---|---| | find-people | Search people from 275M+ database | | enrich-people | Enrich known people with full profiles | | review-people | Deep-review people from a previous search |

Organizations

| Command | Description | |---|---| | find-orgs | Discover companies by criteria | | enrich-org | Enrich organizations by domain | | job-postings | Get active job openings for a company | | company-news | Search news articles for companies |

Web

| Command | Description | |---|---| | web-search | Search the open web | | web-fetch | Fetch & extract info from a URL |

Run lessie help <command> for detailed usage of any command.

Global Options

--env <name>      Environment: prod (default), staging/s6/test
--url <url>       Custom remote MCP server URL (overrides --env)
--pretty          Pretty-print JSON output
--help, -h        Show help
--version, -v     Show version

Environment Variables

| Variable | Description | |---|---| | LESSIE_REMOTE_MCP_URL | Remote server URL (overrides --env) |

Examples

Find senior engineers at AI companies

lessie find-people \
  --filter '{"person_titles":["ML Engineer"],"person_seniorities":["senior"]}' \
  --checkpoint 'Senior ML engineers at AI companies' \
  --strategy saas_only --target-count 20

Find KOL / influencer

lessie find-people \
  --filter '{"platform":"instagram","follower_min":100000,"content_topics":["beauty"]}' \
  --checkpoint 'US beauty influencers' \
  --strategy web_only

Enrich multiple companies

lessie enrich-org --domains '["stripe.com","openai.com"]'

Review candidates from a search

lessie review-people \
  --search-id 'mcp_abc123' \
  --person-ids '["id1","id2"]' \
  --checkpoints '[{"key":"relevance","title":"Relevance","description":"Is this person a senior ML engineer?","category":"career"}]'

Discover companies by criteria

lessie find-orgs \
  --keyword-tags '["AI","SaaS"]' \
  --locations '["United States"]' \
  --employees '["51,200"]'

Authentication

Lessie CLI uses OAuth for authentication. Run lessie auth to authorize — it opens your browser for login and stores tokens locally at ~/.lessie/oauth.json.

Tokens refresh automatically. Run lessie status to check your current auth state.

License

MIT