npm package: @lessie/cli
Description: Lessie CLI — people search, enrichment & web research from the command line
Latest version: 0.4.2

# 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](https://app.lessie.ai) platform.

## Install

```sh
npm install -g @lessie/cli
```

Or run without installing:

```sh
npx @lessie/cli --help
```

## Quick Start

```sh
# 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

```sh
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

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

### Enrich multiple companies

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

### Review candidates from a search

```sh
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

```sh
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