goodvibes-cli

One command. Production-grade project. No config.

goodvibes is a single-command bootstrap for people who want to vibe code with an LLM and not worry about the rest. Run goodvibes init, start coding, and everything else — code hygiene, token efficiency, git discipline, CI/CD — happens automatically in the background.

Quick start

pip install goodvibes-cli
goodvibes init

Or without installing (Node.js):

npx goodvibes-cli init

What you get

goodvibes init sets up five things in your project:

1. CLAUDE.md — Engineering rules that Claude reads automatically on every session: think before coding, simplicity first, fail loud, keep a journal, update tests
2. IDE rule files — The same rules, adapted for your AI coding tool. Supports 14 AI coding tools out of the box: Claude Code, Cursor, GitHub Copilot, Windsurf, Devin Desktop, Kiro, Antigravity, Cline, Amazon Q, Continue.dev, OpenAI Codex CLI, Lovable, Replit Agent, and Bolt.new
3. caveman skill — Compresses Claude's output so you get more done per context window
4. ponytail rules — Keeps code minimal; no over-engineering
5. headroom — Compresses what Claude reads, so context lasts longer (requires Python 3.10+; skipped gracefully if absent)

Running it a second time is safe — existing files are not overwritten, and CLAUDE.md is merged rather than replaced.

Flags

goodvibes init --dry-run    # Preview files without writing anything
goodvibes init --minimal    # Skip headroom install, all .github/ files, and docs/

Requirements

• Python 3.10+
• git
• A GitHub account (for CI)

Windows users: Use WSL2 for the best experience.

IDE support

goodvibes init writes a rule file for each supported AI coding tool. All rule files encode the same engineering principles and activate automatically — no user configuration needed.

Links

• GitHub — source, issues, discussions
• Getting started
• Changelog
• npm package — npx goodvibes-cli init

License

Apache 2.0