Skip to main content
The TalkValue CLI ships as a single npm package, @talkvalue/cli. Install it globally with the package manager of your choice and the talkvalue binary becomes available in any terminal.
Prerequisites
  • Node.js 24 or newer. Check with node --version.
  • A TalkValue account with at least one organization
  • npm, pnpm, yarn, or bun on your $PATH

​
Install

1

Install the CLI globally

Pick the command for your package manager:
# npm
npm install -g @talkvalue/cli

# pnpm
pnpm add -g @talkvalue/cli

# yarn
yarn global add @talkvalue/cli

# bun
bun add -g @talkvalue/cli
2

Verify the install

Open a new terminal so your shell picks up the global bin, then run:
talkvalue version
The installed version prints back. If the command is not found, your package manager’s global bin directory is not on $PATH. Add it and reopen the terminal.
3

Confirm Node.js version

The CLI requires Node.js 24 or newer. Check yours:
node --version
If you need to upgrade, use nvm, fnm, or your OS package manager.

​
Update

The CLI checks npm for new releases in the background and prints a banner when one is available. To check on demand: 
talkvalue update
talkvalue update reports your current version, the latest published version, and the exact install command for your detected package manager (npm, pnpm, yarn, or bun). Re-run that command to upgrade in place.

​
Platform notes

  • macOS: the recommended path is Homebrew-managed Node plus npm install -g. The CLI uses your system keychain to store auth tokens.
  • Linux: install Node via your distro or nvm, then npm install -g. The CLI uses libsecret for keyring access on most distros.
  • Windows: use PowerShell or Windows Terminal. The CLI uses the Windows Credential Manager for token storage.
  • WSL: install inside the Linux side. The CLI behaves identically to native Linux.

​
CI and Docker

Skip talkvalue auth login in non-interactive environments and pass an API token instead: 
export TALKVALUE_TOKEN=<your-token>
talkvalue path person list --json
See Authentication for how to generate the token and Environment variables for the full env reference.

​
Uninstall

# npm
npm uninstall -g @talkvalue/cli

# pnpm
pnpm remove -g @talkvalue/cli
Remove your saved profile too: 
talkvalue auth logout