Skip to main content
The LoneScale CLI (lonescale) is the official command-line client for the LoneScale Public API. Use it to enrich contacts, source contacts by persona, look up companies, and poll async jobs — all from your terminal or a shell script. It’s a thin wrapper around the same REST endpoints documented under API Reference, with terminal-friendly output, file/stdin/inline input, and built-in polling.

​
Install

Or run without installing:
Requires Node.js ≥ 18.

​
Authenticate

Get your API key from Dashboard → Integrations → Public API and provide it in one of three ways (checked in this order):
1

Per-command flag (highest priority)

2

Environment variable

3

Config file

Get my API key

​
Commands

CommandPurpose
lonescale enrichWaterfall enrichment (email / phone) for a list of contacts
lonescale sourceSource contacts at a company by persona, seniority, location
lonescale companies searchLook up a single company by name, domain, LinkedIn slug, or ID
lonescale resultPoll the status / result of an async job

​
Global options

These flags work with every command:
OptionDescription
--api-key <key>LoneScale API key (overrides env + config file)
--output <format>json (default when piped), table (default in TTY), or minimal (just the id/status — script-friendly)
--debugPrint HTTP requests / responses to stderr. API keys are redacted automatically.

​
Output formats

Data goes to stdout, logs go to stderr — so you can pipe results cleanly into jq, xargs, tee, etc.
See Recipes for more scripting patterns.