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). Successful submissions also print the model's current sentiment summary when available.
bash
```
vtcli opinion add --model gpt-5.4 --score 1
```

The CLI resolves canonical full slugs, unambiguous short slugs, and punctuation-only separator variants through the active model catalog. If a slug is ambiguous, use vtcli options list --type model --search <query> before submitting.

`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 and print the current public sentiment summary after the write.

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
--tool-name-other <value>	string	Conditional	Custom tool name, required when --tool-id other is used
--comment <text>	string	No	Free-text comment (max 280 chars)
--json	flag	No	Output 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 options list`

Inspect the active model catalog and valid submission context values before writing an opinion.

Field	Type	Required	Description
vtcli options list --type model --search <query>			Search active models
vtcli options list --type interface			List valid interface values
vtcli options list --type use-case			List valid use-case values
vtcli options list --type tool			List tools grouped by interface
vtcli options list --type tool --interface <value>			List tools for one interface

Add --json to any options command for machine-readable output. Without --search, model listings show a summary instead of dumping the full catalog.

`vtcli model sentiment`

Fetch current sentiment details for a model without submitting a rating.

Field	Type	Required	Description
--model <slug>	string	Yes	Model slug, e.g. gpt-5.4 or openai/gpt-5.4
--json	flag	No	Output raw JSON instead of a summary

Example

bash

vtcli model sentiment --model gpt-5.4

`vtcli skill`

Install the vibetracker-rate agent skill so Codex, Claude Code, Cursor, OpenCode, and other skill-compatible agents can submit honest session feedback through vtcli.

Field	Type	Required	Description
vtcli skill install			Install the vibetracker-rate agent skill with the open skills installer
vtcli skill install --global			Install the skill globally instead of into the current project
vtcli skill install --agent codex			Target a specific agent; repeat --agent for multiple agents
vtcli skill install --source <url>			Install from a fork or alternate skill source

Install globally for Codex

bash

vtcli skill install --global --agent codex

Install flags

Field	Type	Required	Description
--global	flag	No	Install outside the current project
--agent <agent>	string	No	Target an agent such as codex
--copy	flag	No	Copy skill files instead of using installer defaults
--source <source>	string	No	Use a fork or alternate source
--dry-run	flag	No	Print the installer command without running it
--yes	flag	No	Skip installer confirmation prompts

The command delegates to npx skills add, so the skills installer still handles agent detection, install scope, symlink/copy behavior, and prompts. See the agent skill guide for the rating workflow, or open the skill repo.

`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.