Leadgenius cli

LeadGenius 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