vibeads

Package · Setup · Commands · Compare

vibeads is an open-source developer-tool discovery package for Claude Code users. It matches tool activity and project signals against a bundled catalog. Recommendations appear through hooks, spinner text, and a terminal status line.

Install

npm install -g vibeads

Use Node.js with ES module support; repository CI uses Node.js 22. The package has zero runtime dependencies. Installation runs vibeads init automatically. It changes ~/.claude/settings.json and writes files under ~/.vibeads/. Back up your Claude Code settings before installation if you need to restore an existing status line.

Send your first recommendation

vibeads init
vibeads dashboard

No environment variables, credentials, or .env loading are required. Success prints Ready! Start a Claude Code session to see recommendations. The dashboard prints vibeads Stats, impression totals, and configured tiers. Start a Claude Code session in a project with package.json to trigger stack analysis. The status line shows a catalog company and its URL; without a recent match, it selects a random entry.

How it works

Claude Code SessionStart -> project files -> stack profile -> suggestions
Claude Code PostToolUse -> keyword match -> recommendation + local impression
                                         -> spinner settings + occasional context
Stored recommendation -> terminal status line
Local impression file -> dashboard

The matcher reads tool names, commands, paths, selected input fields, and the working directory. Matching and impression tracking make no network requests. Vendor links open external sites when you follow them.

Why it exists

Claude Code supports custom status lines, and ccstatusline provides configurable session widgets. vibeads uses those terminal surfaces for catalog-based developer-tool suggestions. It also uses project dependencies and configuration filenames to suggest alternatives or flag possible stack gaps.

Compare

Scope checked on 2026-10-14 against Claude Code status lines and ccstatusline.

Scope	vibeads	Claude Code custom status line	ccstatusline
Main purpose	Catalog recommendations	User-defined terminal output	Configurable session widgets
Configuration	Installer writes hooks and settings	Script and settings entry	Interactive configuration
Runs locally	Yes	Yes	Yes

Coverage

The matcher reads 20 entries from src/data/portfolio.json. Every row below is catalog-only: no vendor API adapter, account setup, or delivery integration is included.

Catalog company	Status
Clerk	catalog-only
PlanetScale	catalog-only
Stripe	catalog-only
Replicate	catalog-only
Groq	catalog-only
Fal.ai	catalog-only
ElevenLabs	catalog-only
Mistral	catalog-only
Arcjet	catalog-only
Rork	catalog-only
Figma	catalog-only
Stainless	catalog-only
PagerDuty	catalog-only
Hex	catalog-only
Databricks	catalog-only
Runware	catalog-only
Flora AI	catalog-only
Hedra	catalog-only
Cursor	catalog-only
Replit	catalog-only

Source inspection verifies the inventory. No vendor credentials or current catalog pricing claims were verified for this rewrite. The catalog groups these companies under an a16z label; that label does not establish an endorsement.

Common use cases

1. Claude Code users: show developer-tool suggestions alongside coding activity.
2. Next.js builders: use package dependencies and configuration filenames as recommendation signals.
3. Prisma users: surface database catalog entries after matching commands or file activity.
4. Tool evaluators: inspect locally recorded recommendation counts through the dashboard.

Features

• Keyword matching: selects the highest weighted substring match from the catalog.
• Stack analysis: checks dependencies and selected configuration filenames at startup or resume.
• Status line: renders a recent recommendation or a random catalog fallback.
• Spinner text: places the matched company's copy three times before other catalog entries.
• Local dashboard: summarizes recorded matches and the latest detected stack.

See setup and commands for usage.

Runtime surfaces

Command	Behavior
vibeads init	Copy hook files, write settings, and initialize local data
vibeads dashboard	Print local impression and stack summaries
vibeads uninstall	Remove vibeads hooks and local data

The package exposes one bin, vibeads. It has no declared library exports or Model Context Protocol (MCP) server. SessionStart matches startup and resume. PostToolUse matches Bash, Write, Edit, and Read. The installer also configures statusLine and spinnerVerbs.

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗