Headlessly

Terminal interface mirroring the SDK — same verbs, same entities, same semantics.

The CLI mirrors the SDK exactly. Same verbs, same entities, same output.

Install

npm install -g @headlessly/cli
# Or without installing:
npx @headlessly/cli

Auth

npx @headlessly/cli login
# Or if installed globally:
headlessly login

Status

headlessly status

Returns the same structured data as $.status().

Entity Operations

# Create
headlessly Contact.create --name "Alice" --email "alice@vc.com" --stage Lead

# Get
headlessly Contact.get contact_uLoSfycy

# Find
headlessly Contact.find --stage Lead --limit 25

# Update
headlessly Contact.update contact_uLoSfycy --stage Qualified

# Delete
headlessly Contact.delete contact_uLoSfycy

Verb Execution

headlessly do Contact.qualify contact_uLoSfycy
headlessly do Deal.close deal_k7TmPvQx --wonStageId stage_won
headlessly do Issue.assign issue_pQ8xNfKm --assignee user_aK9dGtRw
headlessly do FeatureFlag.rollout new-onboarding --percentage 100

Metrics

headlessly Metric.get mrr
headlessly Metric.get churn_rate
headlessly Metric.dashboard

MCP Server

Start the MCP server for AI agents:

headlessly mcp

Exposes three tools: search, fetch, do.

CLI