dhruvclaudekit

Auto-configure Claude Code for your project's stack. One command, ~30 seconds, sensible stack-aware config — CLAUDE.md, settings.json, skills, hooks, and permissions tailored to your codebase.

No telemetry. Ever.

Install

# Recommended
pipx install dhruvclaudekit

# Zero-install
uvx dhruvclaudekit

# Fallback
pip install --user dhruvclaudekit

Quickstart

cd my-project
dhruvclaudekit init

What it generates

• CLAUDE.md — project conventions, folder structure, run commands
• settings.json — hooks for auto-formatting, safety guards, session info
• Skills — stack-specific guidance (e.g., ML project layout, Next.js App Router patterns)
• Hooks — auto-format on edit, guard dangerous commands, branch protection
• Permissions — allow safe commands, deny destructive ones, ask for risky ones

Supported stacks

How it works

Detection — Walks your file tree (respecting .gitignore), parses manifests (package.json, pyproject.toml, etc.), and scores each preset based on signals like file presence, dependencies, and directory structure.

Planning — Merges core configuration (safety hooks, commit conventions) with stack-specific presets into a unified bundle. Templates are rendered with project-specific context.

Generation — Writes files atomically with automatic backup of any existing .claude/ directory. Supports dry-run mode to preview changes without writing anything.

Step-by-step mode

Use --step-by-step to interactively toggle individual skills and hooks before generating. Recommended only if you have specific customization needs.

--deep mode

Uses Claude to resolve ambiguous detection when rule-based scoring is inconclusive. Requires ANTHROPIC_API_KEY and the deep extra (pipx install 'dhruvclaudekit[deep]'). Estimated cost is shown before any API call.

Safety

• Backup: Existing .claude/ is always backed up before changes (unless --no-backup)
• Dry-run: --dry-run previews all changes without writing a single file
• Atomic writes: Files are written via temp file + fsync + rename — no partial writes
• No telemetry. Ever. This tool makes zero network calls unless you explicitly use --deep

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT