Manage contacts, events, channels, companies, and analytics from the command line.
Built for humans and AI agents. Structured JSON output. 11 agent skills included.

npm install -g @talkvalue/cli

• Prerequisites
• Quick Start
• Why TalkValue CLI?
• Authentication
• Commands
• AI Agent Skills
• Output Format
• Pagination
• Environment Variables
• Exit Codes
• License

• Node.js 24+
• A TalkValue account with at least one organization

talkvalue auth login
talkvalue path person list
talkvalue path event person list 16 --sort joinedAt:desc --json

For humans — stop clicking through the UI to export contacts or check event registrants. Get --help on every command, pipe output to jq, and script your workflows.

For AI agents — every response is structured JSON. Pair it with the included agent skills and your LLM can manage contacts, events, and imports without custom tooling.

# List people in a channel, sorted by join date
talkvalue path channel people 5 --sort joinedAt:desc --json

# Export event registrants to CSV
talkvalue path event person export 16 > registrants.csv

# Analyze a CSV before importing
talkvalue path import analyze --file contacts.csv --json

# Channel attribution across events
talkvalue path analysis channel attribution 3 --event-id 16 --event-id 22 --json

The CLI supports multiple auth workflows so it works on your laptop and in CI.

talkvalue auth login     # browser-based OAuth device flow; select organization

export TALKVALUE_TOKEN=<bearer-token>
talkvalue path person list    # just works

Each profile stores org_id, org_name, member_email, and auth method. Use auth switch to change the active org, or --profile <name> to target a specific one.

All data commands live under the path prefix. Run talkvalue [command] --help for full usage.

The repo ships 11 agent skills (SKILL.md files) — one for every command group, plus recipes for common workflows. Pair them with any AI coding assistant for structured CLI access to TalkValue.

# Install all skills at once
npx skills add https://github.com/talkvalue/cli

# Or pick only what you need
npx skills add https://github.com/talkvalue/cli/tree/main/skills/talkvalue-person
npx skills add https://github.com/talkvalue/cli/tree/main/skills/talkvalue-event

All output — success and errors — is structured JSON when piped. Format is auto-detected:

• TTY (terminal) → table
• Pipe/redirect → json
• Override with --format <format> or --json

{ "data": { ... } }                    // single resource
{ "data": [...], "pagination": {...} } // paginated list

Errors are written to stderr:

{ "error": { "message": "..." } }

Export commands (person export, channel export, etc.) always produce CSV regardless of --format.

--page and --page-size are available on all list subcommands. --sort is available on person, event person, channel people, and company person lists.

talkvalue path person list --page 2 --page-size 50 --sort joinedAt:desc

talkvalue path person get 999999
echo $?   # 4 — not found

ISC