talkvalue auth login

Sign in through the browser, exchange the code for an access token, pick an organization, and save a profile. Run this once per machine before any other command.

Synopsis

talkvalue auth login [--org <name-or-id>]

Options

Flag	Type	Description
`--org <name-or-id>`	string	Organization name or ID. Skip the interactive picker when you already know which workspace you want.

Examples

talkvalue auth login

The CLI prints a one-time code, opens your default browser to the verification page, and waits for you to approve. After approval it polls for the token, lists your organizations, and prompts you to pick one. Output ends with ✓ Logged in as you@example.com (Acme Inc.).

2. Pre-select an organization

talkvalue auth login --org "Acme Inc."
talkvalue auth login --org org_01HXXX...

Matches by name (case-insensitive) or by ID. The picker is skipped entirely, which is useful for scripts that need to re-bind a profile to a known organization.

3. CI environments

For CI you typically skip auth login and use an API token instead:

export TALKVALUE_TOKEN=<your-token>
talkvalue path person list --json

A token in the environment takes precedence over any saved profile. See Authentication for the precedence table.

Response

{
  "data": {
    "email": "you@example.com",
    "loggedIn": true,
    "orgId": "org_01HXXX...",
    "orgName": "Acme Inc.",
    "profile": "you"
  }
}

The access token is stored in your system keyring (Keychain on macOS, libsecret on Linux, Credential Manager on Windows). The profile record on disk holds the organization ID, organization name, your email, and the auth method, never the token itself.

Get Started

Global

Commands

Recipes

AI Agents

Reference

Synopsis

Options

Examples

2. Pre-select an organization

3. CI environments

Response

See also

​Synopsis

​Options

​Examples

​1. Interactive sign-in

​2. Pre-select an organization

​3. CI environments

​Response

​See also

Synopsis

Options

Examples

1. Interactive sign-in

2. Pre-select an organization

3. CI environments

Response

See also