About leadgenius-cli
A command-line skill for operating the LeadGenius Pro B2B platform. It covers lead management, enrichment, scoring, pipeline automation, user administration, and related workflows, with both formatted terminal output and JSON for scripts.
Key features
- 01Search, list, import, and deduplicate leads
- 02Enrich and score leads
- 03Run automated demand pipelines
- 04Manage users, organizations, and campaigns
- 05Use interactive TUI or JSON output
Use cases
- 01Import leads from CSV and enrich records
- 02Run lead scoring and demand-generation workflows
- 03Provision platform users and manage access
- 04Pipe lead data into scripts using JSON output
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/leadgenius-cliin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
.gitignore._package.jsonpackage.json.npmignoreLICENSEREADME.mdpackage-lock.jsonreferences/cli_reference.mduse_cases.mdapi_endpoints.mdworkflows.mdsrc/cli/client-picker.tssrc/cli/commands/account-analysis.tscampaigns.tscompanies.tsauth.tsconfig.tsadmin.tscognito.tsepsimo.tsfsd.tsclients.tsmaintenance.tsleads.tstables.tsgenerate.tsshares.tspipeline.tsusers.tsorg.tsDetails
From the project READMELeadGenius CLI Skill
Operate the LeadGenius Pro B2B platform from the command line. This skill provides the lgp CLI for lead management, enrichment, AI scoring, pipeline automation, user provisioning, and more.
Setup
Install the CLI globally:
npm install -g leadgenius-cli
Set the API key (persists across sessions):
lgp config set api-key lgp_YOUR_KEY_HERE
lgp auth test
Credentials are saved to ~/.leadgenius-cli/session.json and auto-loaded on subsequent runs.
Core Workflows
Search and list leads
# Smart search — auto-detects email, name, or URL, case-insensitive
lgp leads search -q "Jane Doe"
lgp leads search -q "[email protected]"
# List leads for a client (shows interactive client picker if -c omitted)
lgp leads list
lgp leads list -c <client-id> --limit 20
Import leads from CSV
lgp leads import --file leads.csv
CSV headers map directly to API fields: firstName, lastName, email, companyName, title, linkedinUrl, etc. The CLI prompts for client selection.
Enrich, score, and generate AI content
lgp tasks enrich --lead <id>
lgp tasks score --lead <id>
lgp tasks copyright --lead <id>
Run FSD pipeline (full automation)
lgp fsd run -c <client> --icp <id> --enrich --score
lgp fsd status <pipelineId>
lgp fsd campaigns
Provision a new user for UI login at last.leadgenius.app
# Creates Cognito user + CompanyUser + optional API key
lgp users provision -e [email protected] -p "SecurePass123!" --company-id <id> --role admin --group admin
# Set UI access (requires admin key)
lgp cognito set-attributes -e [email protected] --attributes '{"custom:allowed_views":"role:companyAdmin|*"}'
Manage territory companies
lgp companies list -c <client>
lgp companies leads <companyId>
lgp companies content-analysis <companyId>
lgp companies aggregate -c <client>
lgp companies events radar
EpsimoAI credits and threads
In TUI mode (lgp with no args), EpsimoAI authenticates automatically via Cognito token exchange. In CLI mode:
lgp epsimo activate --cognito-token <jwt>
lgp epsimo info -t <token>
lgp epsimo credits -t <token>
lgp epsimo threads -t <token>
Report bugs and request features
lgp maintenance bugs report --desc "Description of the issue" --email [email protected]
lgp maintenance enhancements request --desc "Feature idea" --email [email protected]
lgp maintenance bugs list
All Command Groups
| Group | Description | Key Commands |
|---|---|---|
auth | Test connection | auth test |
leads | Lead CRUD, search, import, dedup | list, search -q, import --file, dedup |
tasks | Background jobs | enrich, score, copyright |
fsd | Full-Stack Demand pipeline | run, campaigns, status |
companies | Territory intelligence | list, leads, aggregate, events |
users | User management | list, create, provision, menu-config |
org | Company management | list, create, rename, add-user |
cognito | Cognito user pool (admin) | list, get, create, set-attributes |
epsimo | EpsimoAI integration | activate, info, credits, threads |
tables | Generic CRUD for any table | list <Table>, create, update, delete |
generate | Lead generation | from-icp, direct, schedule |
campaigns | ABM campaigns | list, create |
clients | Client management | list, create |
shares | Shared links | create, extend, revoke |
webhooks | Inbound events | list, get, reprocess |
maintenance | Bugs & enhancements | bugs list/report, enhancements list/request |
pipeline | Analytics | --start --end |
account-analysis | Account intelligence | list, analyze, export |
admin | Backups, PITR, system | backup, pitr, org-tree, views |
config | Session management | show, set, get, reset |
Output Format
By default, the CLI shows smart-formatted output with tables, colors, and progress bars. Use --format json for raw JSON (useful for piping to jq or scripts):
lgp leads list -c <id> --format json | jq '.data[].email'
Interactive TUI
Launch with no arguments for a menu-driven interface:
lgp
The TUI provides client picker dropdowns, auto-authentication for EpsimoAI, and all commands accessible via menus.
API Base URL
https://api.leadgenius.app/api/automation/
Environment Variables
| Variable | Description |
|---|---|
LGP_API_KEY | API key (lgp_ prefix) |
LGP_URL | Base URL (default: https://api.leadgenius.app) |
LGP_ADMIN_KEY | Admin key for cognito/admin commands |
Reference Docs
- Full CLI README
- API Endpoints — all REST endpoints with request/response examples
- CLI Reference — detailed flag documentation
- Workflows — step-by-step business workflows
- Use Cases — end-to-end scenarios