🔭 VibeRadar

Live module map with test coverage for vibecoding projects.

Run it in any project root — VibeRadar scans your source files, reads Playwright/Istanbul coverage, and opens an interactive dashboard in your browser.

Usage

npx viberadar

Agent Env Config

VibeRadar reads runtime agent settings from .viberadar.env in the project root (where you run npx viberadar). If the file is missing, VibeRadar creates it automatically with defaults. OS environment variables override file values.

Default file:

VIBERADAR_AGENT_QUEUE_MAX=5
VIBERADAR_AGENT_COOLDOWN_MIN_MS=20000
VIBERADAR_AGENT_COOLDOWN_MAX_MS=60000
VIBERADAR_AUTO_FIX_FAILED_TESTS=true
VIBERADAR_AUTO_FIX_MAX_RETRIES=1
VIBERADAR_CODEX_SANDBOX=workspace-write

Opens http://localhost:4242 with a live map of:

• All source modules (TypeScript, JavaScript, Vue, Svelte)
• Which ones have tests and which don't
• Coverage metrics (lines, statements, functions, branches)
• Module sizes and local dependency graph

Dashboard

• Filter by type — component, service, util, test, config
• Search by name or path
• Click any card to see full coverage breakdown and dependencies

Coverage data

VibeRadar reads coverage from coverage/coverage-summary.json (Istanbul/V8 format).

Generate it with:

# Vitest
npx vitest run --coverage

# Jest
npx jest --coverage

# Playwright (with coverage plugin)
npx playwright test

Logging standard

Repository includes an observability baseline for structured logs:

• Standard document: docs/observability/logging-standard.md
• Error code dictionary: config/logging-error-codes.json
• CI/lint command: npm run lint:logs
• Lint self-check tests: npm run test:lint-logs

Tech

• CLI: TypeScript + Node.js
• Dashboard: vanilla HTML/JS (zero dependencies in browser)
• Server: Node.js http module
• Port: 4242

Release to npm

To avoid forgetting npm publication after changes, use release scripts:

# Patch release (0.3.56 -> 0.3.57)
npm run release:patch

# Minor release (0.3.x -> 0.4.0)
npm run release:minor

# Major release (0.x -> 1.0.0)
npm run release:major

Each command runs typecheck + build first, then bumps version and publishes to npm.

Before running release scripts, make sure you are authenticated:

npm whoami

License

MIT