CLI

Rate AI models, leave comments, and track sentiment — all from your terminal. vibetracker-cli wraps the Vibetracker API into a fast, scriptable command-line tool.

GitHub npm

Install

bash

npm install -g vibetracker-cli

Requires Node.js 18 or later.

Quick start

1
Authenticate
This opens a browser window where you approve the CLI. Once confirmed, you're ready to go.
bash
```
vtcli auth login
```
2
Submit an opinion
Scores are -1 (negative), 0 (neutral), or 1 (positive).
bash
```
vtcli opinion add --model gpt-5.4 --score 1
```

`vtcli auth`

Manage authentication credentials.

Field	Type	Required	Description
vtcli auth login			Sign in via browser
vtcli auth login --api-key <key>			Authenticate with an API key (useful for CI)
vtcli auth logout			Remove stored credentials
vtcli auth status			Show current auth info

For CI environments, use vtcli auth login --api-key or set the VTCLI_API_KEY environment variable. Create an API key from your account settings.

`vtcli opinion add`

Submit sentiment for an AI model.

Field	Type	Required	Description
--model <slug>	string	Yes	Model slug, e.g. gpt-5.4 or openai/gpt-5.4
--score <-1\|0\|1>	integer	Yes	Negative, neutral, or positive sentiment
--use-case <value>	string	No	What you were doing, e.g. coding
--interface <value>	string	No	How you used the model, e.g. api
--tool-id <value>	string	No	Tool identifier, e.g. openai-api
--comment <text>	string	No	Free-text comment (max 280 chars)
--json	flag	No	Output raw JSON instead of a summary
--update-optional-context	flag	No	Update context on an existing active opinion

Full example

bash

vtcli opinion add \
  --model gpt-5.4 \
  --score -1 \
  --use-case coding \
  --interface api \
  --tool-id openai-api \
  --comment "Regression in tool calls after the latest deploy."

`vtcli config`

View and update CLI configuration.

Field	Type	Required	Description
vtcli config show			Show current configuration
vtcli config set-base-url <url>			Point the CLI at a different server

Environment variables

Environment variables override values stored in ~/.vtcli/config.json.

Field	Type	Required	Description
VTCLI_API_KEY	string	No	Use this API key instead of the stored one
VTCLI_BASE_URL	string	No	Use this base URL instead of the default

The CLI uses the same API under the hood. For full field details, see the POST /api/v1/opinions reference.