Skip to main content

Install

Use the public npm package:
npm install -g @trigify/cli
The installed binary is trigify. Verify with:
trigify --version
Then authenticate: trigify login
The CLI requires Node.js 20 or newer. See the full installation guide for API key setup, agent skills, and more.

What The CLI Covers

The public CLI is organized around these top-level command groups:
CommandPurpose
trigify login, logout, whoamiAuthentication and account identity
trigify searchSaved search and monitor management
trigify workflowWorkflow creation, drafts, publishing, and testing
trigify integrationConnected integration metadata and health checks
trigify profile, company, post, discoverLinkedIn profile, company, post, and creator data
trigify xX posting and engagement actions
trigify credits, org, usageBilling, org, and usage summaries

Global Options

These options are available at the root command level and can be combined with any subcommand:
FlagDescription
--base-url <url>Override the API base URL. Defaults to the API URL baked into the installed build.
--api-key <key>Use an API key instead of OAuth credentials for the current invocation.
-h, --helpShow command help.
-V, --versionShow the installed CLI version.
Examples:
trigify --version
trigify --help
trigify --api-key trig_your_api_key search list
trigify --base-url https://trigify-api-staging.up.railway.app whoami
Build defaults:
  • Local source builds default to http://localhost:3333
  • Staging builds default to https://trigify-api-staging.up.railway.app
  • Stable builds default to https://api.trigify.io

Output Format

CLI commands return JSON by default. Successful commands are wrapped in a success envelope:
{
  "success": true,
  "data": {
    "id": "ss_123",
    "name": "Competitor mentions"
  }
}
Failures return a structured error envelope:
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Missing required --id option"
  }
}
Some commands also emit informational messages to stderr, for example when OAuth sessions are refreshed or workflow JSON is auto-fixed before validation.

Common Workflows

Authenticate interactively

trigify login
trigify whoami
trigify search create \
  --name "AI coding assistants" \
  --monitoring-type linkedin-posts \
  --keywords '["AI coding assistant","Codex","Claude Code"]'

trigify search list

Create a workflow from a local JSON file

trigify workflow create \
  --name "New post notifier" \
  --workflow-file ./workflow.json \
  --status DRAFT