May 2026 CLI / API Developer

Vibetracker CLI

A command-line companion for VibeTracker that lets developers authenticate, submit model sentiment, and script feedback from terminal workflows.

Node.jsTypeScriptVibeTracker APIWorkOS AuthKitConvex
VibeTracker open graph artwork showing the VibeTracker brand.

Vibetracker CLI brings the VibeTracker contribution model into the terminal. It is aimed at developers and power users who notice model quality while they are already working in command-line tools, scripts, or CI environments.

The CLI supports browser-based login, API-key authentication, local credential status, configurable server targets, JSON output, and sentiment submission with optional context such as use case, interface, tool ID, and comments.

Example workflow

Terminal
npm install -g vibetracker-cli
vtcli auth login
vtcli opinion add --model gpt-5.4 --score 1 --use-case coding --interface api

Why it matters

The web app captures casual public feedback, while the CLI makes the same data model useful in the places heavy AI users already work. That creates a path for richer, more timely model-quality signals without forcing every contribution through a browser UI.

Challenges

  • Designing auth flows that work both interactively through a browser and non-interactively with API keys.
  • Keeping CLI flags aligned with the public API without duplicating product rules in too many places.
  • Making output readable by humans while still supporting scriptable JSON responses.

What I Learned

  • A small CLI can be a strong extension of a web product when it maps directly to real user workflow moments.
  • API design gets sharper when a CLI has to expose the same concepts through concise flags and useful errors.