@rich-apis/vibe-tools

CLI toolkit for the stuff you keep re-doing. Env validation, JSON-to-TypeScript, changelogs, dependency audits, tsconfig, gitignore, README scaffold. One install, seven commands, zero config.

No runtime dependencies. Node.js 18+.

Install

npm install -g @rich-apis/vibe-tools

Or run directly:

npx @rich-apis/vibe-tools env

Commands

vibe env - Validate .env files

Catches missing variables, duplicates, syntax errors, and leaked secrets. Compares against .env.example if one exists.

vibe env                          # check .env against .env.example
vibe env .env.production          # check a specific file
vibe env --strict                 # fail on warnings too (CI mode)
vibe env --example .env.template  # custom example path

Returns exit code 1 on errors. Drop it in CI.

vibe json2ts - JSON to TypeScript

Reads JSON from a file or stdin, outputs TypeScript interfaces. Handles nested objects and arrays.

vibe json2ts data.json
vibe json2ts -n User api-response.json
echo '{"id": 1, "name": "test"}' | vibe json2ts
vibe json2ts --export -n Config settings.json

vibe changelog - Changelog from git

Reads git log and groups commits. Recognizes Conventional Commits if you use them, works fine if you don't.

vibe changelog
vibe changelog --from v1.0.0 --to v1.1.0
vibe changelog --format plain

vibe depcheck - Find unused dependencies

Scans source files for import/require statements and compares against package.json. Finds unused deps and missing deps.

vibe depcheck
vibe depcheck --dev                     # include devDependencies
vibe depcheck --ignore eslint           # skip specific packages
vibe depcheck ./packages/api            # check a subdirectory

Outputs the exact npm commands to fix what it finds.

vibe tsconfig - Generate tsconfig.json

Outputs a tsconfig.json for common project types. Prints to stdout so you can review before saving.

vibe tsconfig                         # Node.js defaults
vibe tsconfig --type react            # React / Next.js setup
vibe tsconfig --type library          # npm library setup
vibe tsconfig --type react --write    # write to ./tsconfig.json

Three presets: node, react, library. All strict by default.

vibe gitignore - Generate .gitignore

Outputs a .gitignore for common project types. Four presets, stdout by default.

vibe gitignore                        # Node.js defaults
vibe gitignore --type react           # React / Next.js
vibe gitignore --type python          # Python
vibe gitignore --type go              # Go
vibe gitignore --write                # write to ./.gitignore
vibe gitignore --append --type python # add python rules to existing file

vibe readme - Scaffold README.md

Generates a README from your package.json. Pulls name, description, install instructions, scripts, and license.

vibe readme                           # print to stdout
vibe readme --write                   # write to ./README.md
vibe readme > README.md               # same thing, with redirect

vibe license - License management

vibe license              # show current tier
vibe license VT-PRO-XXXX # activate a key

Tiers

| Feature | Free | Pro ($5) | Premium ($25) | |---------|------|----------|---------------| | All 7 commands | yes | yes | yes | | --json output | - | yes | yes | | --group (changelog) | - | yes | yes | | --readonly (json2ts) | - | yes | yes | | Batch processing | - | coming | coming | | CI/CD integration | - | - | coming | | Custom rules | - | - | coming |

One-time purchase. No subscription.

Upgrade: https://rich-apis.store/vibe-tools

Requirements

Node.js 18+

License

MIT