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