Nudgen CLI

Run retention email from the command line

Manage contacts, campaigns, and referrals from the terminal β€” for you and the agents you already use.

Install in seconds

One line in your terminal β€” works on macOS, Linux, and Windows.

curl -fsSL https://cli.nudgen.net | bash

Installing with Go instead?

go install github.com/Nudgen-Marketing/nudgen-cli@latest

Contact & CRM Management

List, create, update, delete, and import contacts directly from your terminal.

Campaign Orchestration

Deploy, monitor, and manage email marketing campaigns with terminal efficiency.

Referral Tracking

Monitor referral click activity and payout history in real time.

Multi-team Auth

Authenticate via PAT, switch between teams, and manage brand identities securely.

Good to know: Every command supports the --json flag for machine-readable output, making it perfect for CI/CD pipelines and AI agent workflows.

What you can run

Everyday workflows you can run without opening the dashboard.

Authenticate via Personal Access Token.

nudgen login

Check current authenticated identity.

nudgen whoami

List all teams you belong to.

nudgen teams list

Switch to a different team context.

nudgen teams switch <id>

List active contacts in current team.

nudgen contacts list

Create a new contact interactively.

nudgen contacts create

Update an existing contact interactively.

nudgen contacts update <id>

Delete a contact by ID.

nudgen contacts delete <id>

Import contacts from CSV file.

nudgen contacts import

List active campaigns in current team.

nudgen campaigns list

List brand identities for the team.

nudgen brand list

View recent referral click history.

nudgen referral activity

View your payout history.

nudgen referral payouts

On your device

Team context and your sign-in stay on this computer:

  • config.json

    Persistent team context (activeTeamId)

  • System keychain

    Secure storage for your PAT token