Project Description

Configuring Claude Code for a new project used to take hours: copying agents, adjusting skills, setting up MCP servers, defining permissions, configuring standards, replacing placeholders. Every project ended up slightly different because something was always forgotten.

Claude Code Config automates all of this. Run one command, answer a few questions, and get a fully configured Claude Code environment in minutes. The CLI detects your stack, suggests relevant modules, configures standards, and handles all the tedious configuration work.

Key Features

Smart Stack Detection

The CLI analyzes your project and automatically detects:

• Package manager: pnpm, npm, yarn, bun
• Framework: React, Next.js, Astro, Hono, Express, NestJS, Fastify
• Database: Drizzle, Prisma, Mongoose
• Testing: Vitest, Jest, Playwright

1
$ qazuor-claude-config init
2

3
Detecting project setup...
4
  ✓ Package manager: pnpm
5
  ✓ Framework: Hono (detected from dependencies)
6
  ✓ Database: Drizzle (detected from scripts)
7
  ✓ Testing: Vitest (detected from devDependencies)
8

9
Suggested bundles based on your stack:
10
  ◉ stack-hono-drizzle
11
  ◉ testing-complete

Modular Architecture

100+ modules organized into 5 categories:

Install only what you need. Each module is independent but can be combined through bundles.

23 Pre-configured Bundles

Stack-specific bundles that install related modules together:

1
# Stack bundles
2
stack-react-tanstack    # React + TanStack Query/Router
3
stack-astro-react       # Astro + React Islands
4
stack-hono-drizzle      # Hono + Drizzle ORM
5
stack-nextjs-prisma     # Next.js + Prisma
6
stack-express-prisma    # Express + Prisma
7

8
# Category bundles
9
testing-complete        # Full testing suite
10
testing-minimal         # Essential testing tools
11
quality-complete        # All quality commands
12
database-drizzle        # Drizzle engineer + skills
13
database-prisma         # Prisma engineer + skills

27 Verified MCP Servers

Pre-configured integrations for external tools:

• Documentation & Search: Context7, Brave Search, Perplexity
• Databases: PostgreSQL, Neon, MySQL, Redis, Supabase
• Version Control: GitHub, GitLab, Git
• Deployment: Vercel, Cloudflare, Docker, AWS
• Testing: Playwright, Chrome DevTools
• Communication: Slack, Linear, Notion
• Payments: Stripe, Mercado Pago
• Design: Figma, Shadcn UI, Magic UI

1
? Which MCP servers do you want to configure?
2
  ◉ github (Suggested: detected GitHub remote)
3
  ◉ postgres (Suggested: detected database dependency)
4
  ◯ vercel
5
  ◯ stripe

Project Standards Wizard

Configure project-wide standards across 6 categories with 5 presets (strict, balanced, relaxed, startup, enterprise):

Code Standards - Indent style, quotes, semicolons, line length, TypeScript rules, JSDoc requirements

Testing Standards - Coverage targets (60-95%), TDD requirements, test patterns, file location preferences

Documentation Standards - JSDoc levels, example requirements, changelog formats, comment policies

Design Standards - CSS framework, component library, accessibility level (A/AA/AAA), dark mode support

Security Standards - Authentication pattern, input validation, CSRF protection, rate limiting

Performance Standards - Core Web Vitals targets (LCP, FID, CLS), bundle size and API response time limits

Pre-commit Hooks Configuration

Configurable Git hooks via Husky with three presets:

• Minimal: Lint only
• Standard: Lint + typecheck
• Strict: Lint + typecheck + tests

Supports Biome or ESLint, TypeScript checking, test execution on staged files, and custom validation commands.

Response Style Customization

Customize how Claude communicates:

• Tone: Friendly, professional, formal, strict, mentor
• Verbosity: Concise, balanced, detailed
• Language: English, Spanish, or auto-detect
• Error reporting: Supportive, neutral, or direct
• Proactivity: Level of unsolicited suggestions

Four presets available: friendly, professional, strict, mentor.

Granular Permission Control

Three permission presets with customization options:

• Default: Balanced security and productivity
• Trust: Full operations except git push
• Restrictive: Read-only for sensitive codebases

1
{
2
  "allow": ["Read", "Edit", "Write", "Bash(pnpm run *)", "Bash(git status)"],
3
  "deny": ["Bash(rm -rf *)", "Bash(git push --force)"]
4
}

Automatic Placeholder Replacement

Templates include placeholders like {{PROJECT_NAME}}, {{GITHUB_ORG}}, {{DOMAIN}}. The CLI:

1. Detects values from package.json and git
2. Prompts for missing values
3. Replaces across all files automatically
4. Saves preferences in ~/.claude/defaults.json for reuse

1
Scanning files for placeholders...
2
  .claude/CLAUDE.md - 12 replacements
3
  .claude/agents/tech-lead.md - 3 replacements
4
  .claude/commands/commit.md - 2 replacements
5

6
✓ 47 files updated with 156 replacements

Code Style Tooling

Integrated configuration for development consistency:

• EditorConfig: Editor-agnostic rules (indent, line endings)
• Biome: Fast linting and formatting
• Prettier: Opinionated code formatting
• Commitlint: Conventional commit validation

Commands

init

Complete setup wizard for new projects:

1
qazuor-claude-config init [path]

Options: --bundle, --template, --dry-run, --force

list

Display available modules, bundles, or MCP servers:

1
qazuor-claude-config list agents
2
qazuor-claude-config list skills
3
qazuor-claude-config list bundles
4
qazuor-claude-config list mcp

add / remove

Manage individual modules:

1
qazuor-claude-config add agent tech-lead
2
qazuor-claude-config add skill api-testing
3
qazuor-claude-config remove command review-code

configure

Reconfigure template placeholders:

1
qazuor-claude-config configure [--scan] [--preview] [--category <name>]

standards

Configure project standards:

1
qazuor-claude-config standards [--preset <name>] [--category <name>]

status

Show current configuration:

1
qazuor-claude-config status [--verbose] [--json]

update

Update configuration and modules:

1
qazuor-claude-config update [--modules] [--config]

Additional Generators

Beyond modules, the CLI can generate:

• CLAUDE.md: Dynamic project instructions file
• Code Style: EditorConfig, Biome, Prettier, Commitlint
• Git Hooks: Husky with commit-msg and pre-commit
• CI/CD: GitHub Actions workflows
• VSCode: Settings and extension recommendations

Technical Details

Requirements

• Node.js 18.0+
• pnpm, npm, yarn, or bun
• Git (optional but recommended)

Installation

1
# Global installation (recommended)
2
pnpm add -g @qazuor/claude-code-config
3

4
# Or run directly without installation
5
npx @qazuor/claude-code-config init

Stack

• Runtime: Node.js with ESM
• Language: TypeScript 5.7+ (strict mode)
• CLI Framework: Commander.js
• Prompts: Inquirer.js
• Styling: chalk, ora, figlet
• Testing: Vitest with memfs

Programmatic API

Available as an npm package for Node.js applications, providing functions for:

• Reading/writing configuration
• Loading module registry
• Detecting project types
• Processing templates
• Resolving bundles
• Managing placeholders

TypeScript types included for all functionality.

Status

Active development with new features being added regularly. Stable for production use.

Why I Built This

Every new project meant hours of repetitive configuration. Copy agents from another project, adjust settings, configure MCP servers, replace placeholders manually. Each project ended up slightly different.

This tool solves that: consistent, automated configuration in minutes instead of hours. It’s opinionated (TypeScript, TDD, layered architecture) but modular enough to adapt to different stacks.

The goal is to spend time solving problems, not configuring tools.