Code kit vlv

Turn a fresh repo into an AI-ready workspace in minutes.

code-kit-vlv is the free, MIT-licensed CLI that sets up the boring-but-critical project guidance you usually forget until an agent breaks something: repo rules, command docs, safe npm defaults, Caveman guidance, optional UI/UX Pro pruning, Husky hooks, and agent-specific files for Codex, Claude, and OpenCode.

One command. Less setup drift. Better agent output. ✨

npm package · Command guide · Presets · Security notes

Why It Rocks

You get	Why it matters
⚡ Fast repo onboarding	Start with a useful agent-ready structure instead of writing rules from scratch every time.
🧠 Smarter coding agents	Codex, Claude, and OpenCode get project context, commands, boundaries, and expectations.
🛡️ Safer npm defaults	Adds a conservative .npmrc policy with audit enabled, exact saves, and lifecycle scripts blocked by default.
🧱 Repeatable presets	Bootstrap npm packages, Vite apps, vanilla apps, Angular projects, and macOS Swift apps.
🦾 Caveman-first workflow	Caveman is enabled by default in ultra mode, while still letting you choose another mode.
🎨 UI/UX Pro cleanup	Keeps design guidance focused on your stack instead of dragging unrelated framework files around.
💸 Free and open	MIT license. Use it, fork it, ship with it.

The Pitch

Most repos do not fail because they lack code. They fail because the next person, or the next coding agent, has to guess:

• Which command validates the project?
• Which files are generated?
• What should never be overwritten?
• Which agent files are canonical?
• What project type is this?
• Is this repo using Codex, Claude, OpenCode, or all of them?

code-kit-vlv answers those questions upfront and keeps the answers synchronized.

npm install -g code-kit-vlv
code-kit-vlv init

Short alias:

ckv init

What It Creates

your-project/
├─ AGENTS.md
├─ CLAUDE.md
├─ OPENCODE.md
├─ .npmrc
├─ docs/
│  ├─ agent-guidance.md
│  ├─ commands.md
│  ├─ presets.md
│  ├─ release.md
│  ├─ security.md
│  └─ skills.md
└─ .codex/
   └─ skills/
      ├─ caveman/
      └─ uiux-pro/

Exact output depends on the preset and choices you select.

Quick Start

Interactive setup:

code-kit-vlv init

Language-specific setup:

code-kit-vlv init --language en
code-kit-vlv init --language es

Noninteractive preset setup:

code-kit-vlv init --preset npm-package --language en
code-kit-vlv init --preset vite --language en
code-kit-vlv init --preset angular --language es

Accept default npm-package choices:

code-kit-vlv init --yes --language en

Presets

Preset	Best for	Includes
npm-package	Public or private Node packages	Git, Husky, Caveman ultra, .npmrc, release docs
vite	Modern frontend apps	Git, Husky, Caveman ultra, UI/UX Pro, .npmrc
vanilla	HTML/CSS/JS or TypeScript apps	Vanilla-focused UI/UX guidance and agent docs
angular	Angular workspaces	Angular-aware guidance, UI/UX pruning, project validation notes
macos-swift	Native Mac apps	Swift-oriented command docs and agent guidance

Commands

Command	What it does
code-kit-vlv init	Starts the guided setup for the current project.
code-kit-vlv doctor	Checks missing or stale guidance, scripts, metadata, and policy files.
code-kit-vlv doctor --json	Prints a machine-readable doctor report.
code-kit-vlv sync --dry-run	Previews managed guidance updates.
code-kit-vlv sync --yes	Updates managed generated sections.
code-kit-vlv add caveman	Adds or refreshes Caveman guidance.
code-kit-vlv add uiux	Adds or prunes UI/UX Pro guidance for your stack.
code-kit-vlv add husky	Adds a Husky pre-commit hook.
code-kit-vlv add npmrc	Adds or merges the safe npm policy.
code-kit-vlv add agent codex	Adds Codex guidance.
code-kit-vlv add agent claude	Adds Claude guidance.
code-kit-vlv add agent opencode	Adds OpenCode guidance.
code-kit-vlv list	Lists built-in presets, agents, and skills.
code-kit-vlv version	Prints the installed package version.

Built For Agent Work

code-kit-vlv is not just a file generator. It is a repo alignment tool.

It gives coding agents a stable operating contract:

• read existing files before editing
• preserve manual notes outside managed markers
• avoid silent overwrites
• document validation commands
• keep generated guidance synchronized
• separate local commits, pushes, releases, and publication

That means less "what is this repo?" overhead and more useful implementation time.

Caveman by Default

Caveman is the default skill because strong agent behavior starts with strong operating rules.

During init, code-kit-vlv preselects:

Caveman mode: ultra

You can still choose full, lite, or skip it when that fits the project better.

UI/UX Pro Without the Mess

UI/UX Pro is powerful, but a repo should not carry irrelevant framework guidance forever.

code-kit-vlv add uiux keeps the useful design direction and prunes the rest based on your stack:

Stack	Guidance focus
Vanilla	HTML, CSS, TypeScript, general UX
React	React and general web UX
Next.js	Next.js, React, routing, product UX
Angular	framework-agnostic web UX, typography, color, design systems
SwiftUI	native app and mobile-style product guidance

If a UI/UX Pro folder is missing, the CLI creates local stack-aware guidance instead of failing.

Safety First

Generated Markdown uses stable managed markers, so sync can update generated sections without touching your handwritten notes.

The npm policy is intentionally conservative:

loglevel=error
fund=true
audit=true
ignore-scripts=true
save-exact=true

That keeps installs quieter, dependency versions exact, audits visible, and lifecycle scripts blocked unless you explicitly decide otherwise.

Example Flow

# 1. Install the CLI
npm install -g code-kit-vlv

# 2. Initialize a Vite project
code-kit-vlv init --preset vite --language en

# 3. Check the repo guidance
code-kit-vlv doctor

# 4. Preview future generated updates
code-kit-vlv sync --dry-run

# 5. Add another agent later
code-kit-vlv add agent claude

Free, Practical, Yours

code-kit-vlv is built for people who create a lot of repos and want every one of them to start with real operating context.

No dashboard. No subscription. No setup ceremony.

Just a CLI that saves time, reduces repeated decisions, and makes agent-assisted development feel less chaotic.

License

MIT