> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trytalkvalue.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install

> Install the TalkValue CLI via npm and verify the global binary on macOS, Linux, or Windows.

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.

<Note>
  **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`
</Note>

## Install

<Steps>
  <Step title="Install the CLI globally">
    Pick the command for your package manager:

    ```bash theme={null}
    # npm
    npm install -g @talkvalue/cli

    # pnpm
    pnpm add -g @talkvalue/cli

    # yarn
    yarn global add @talkvalue/cli

    # bun
    bun add -g @talkvalue/cli
    ```
  </Step>

  <Step title="Verify the install">
    Open a new terminal so your shell picks up the global bin, then run:

    ```bash theme={null}
    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.
  </Step>

  <Step title="Confirm Node.js version">
    The CLI requires Node.js 24 or newer. Check yours:

    ```bash theme={null}
    node --version
    ```

    If you need to upgrade, use [`nvm`](https://github.com/nvm-sh/nvm), [`fnm`](https://github.com/Schniz/fnm), or your OS package manager.
  </Step>
</Steps>

## Update

The CLI checks npm for new releases in the background and prints a banner when one is available. To check on demand:

```bash theme={null}
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:

```bash theme={null}
export TALKVALUE_TOKEN=<your-token>
talkvalue path person list --json
```

See [Authentication](/cli/authentication) for how to generate the token and [Environment variables](/cli/environment-variables) for the full env reference.

## Uninstall

```bash theme={null}
# npm
npm uninstall -g @talkvalue/cli

# pnpm
pnpm remove -g @talkvalue/cli
```

Remove your saved profile too:

```bash theme={null}
talkvalue auth logout
```

## Related

* [Quickstart](/cli/quickstart). Run your first command in 60 seconds.
* [Authentication](/cli/authentication). Sign in interactively or with a token.
* [Environment variables](/cli/environment-variables). Full env reference.