About this project

Project Calavera is an open-source CLI tool that scaffolds linters, formatters, TypeScript configurations, AI agent skills, hooks, and other common project infrastructure for web projects. It can work standalone for vanilla JavaScript, TypeScript, and library projects, or complement framework scaffolding tools like Vite+. Core capabilities include managing linting and formatting tooling (choosing between Modern profile with Oxlint/Oxfmt/Stylelint or Classic profile with ESLint/Prettier/Stylelint), generating TypeScript configs that check `.js`, `.jsx`, `.ts`, and `.tsx` files, and setting up Stylelint with CSS quality plugins. It also supports AI skill and agent installation under `.agents/`, manages `package.json` scripts, and produces a repeatable `calavera.config.json` recipe file. The tool integrates with multiple package managers—npm, pnpm, Yarn, and Bun—with documented command variations for each. It supports project-local MCP server configuration for Claude Code, Codex, Cursor, and OpenCode, exposing tools such as `inspect_project`, `list_profiles`, `compose_recipe`, `dry_run_apply`, and `apply_recipe` for agent-native workflows. Calavera includes an integration catalog covering React best practices (with React Doctor diagnostics), import/module rules, Promise safety, Node package rules, test rules, unused file/dependency analysis via Knip, HTML validation, CSS baselines and property validation, and environment variable schema validation via Varlock. Optional GitHub repository controls generate policy files, Dependabot configuration, and a portable Node.js administration script for drift checking. The CLI provides commands for recipe composition (`init`), applying recipes with dry-run preview (`apply --dry-run`), inspecting current project tooling (`doctor`), updating managed tooling (`update`), and removing stale files (`clean`). Interactive and scripted modes are both supported, and a Web UI is available for browser-based recipe composition. MCP server registration is project-local only; Calavera never writes global or user-level MCP configuration. The tool respects existing project package managers to avoid preflight failures, especially with Bun-managed projects where npm 11 enforces `devEngines.packageManager` checks.