create-claude

Claude Code setup that just works. Bootstrap every project with agents, hooks, commands, and smart permissions. One command, zero headaches.

Quick Start

npm create claude

Adds local Claude Code config files to your project. ZERO dependencies, ZERO overhead.

Installation Options

Package Managers

npm create claude               # npm
pnpm create claude              # pnpm  
bun create claude               # bun
yarn create claude              # yarn

Flags

npm create claude --dry-run     # Preview files
npm create claude --help        # All options

Shortcuts

cld                             # Short alias
npx cld                         # Via npx

Programmatic Usage

Installation

npm i create-claude

Usage

import { init } from 'create-claude';

await init('./my-project');

Features

Maximum Autonomy with Safety

• bypassPermissions mode: Claude Code operates freely while dangerous operations are blocked
• Smart safety hooks: Only blocks truly destructive commands (rm -rf /, sudo rm, disk formatting)
• Delete confirmations: All file/directory deletions require explicit user approval

8 Custom Slash Commands

• /commit: Create git commits with Haiku model for cost efficiency
• /explain: Get concise code explanations
• /fix: Fix issues with structured approach
• /optimize: Performance improvements
• /pr: Create pull requests with git context
• /review: Brutal code reviews
• /test: Run tests with pattern support
• /validate: Lint, typecheck, and format

3 Specialized Subagents

• pre-commit: Ruthless validation before commits
• refactor: Aggressive complexity reduction
• debugger: Root cause analysis and fixes

Production-Ready Configuration

• Session hooks: Automatic cleanup on exit
• Advanced statusline: Git status, framework detection, color-coded information with modular helpers
• Import-based memory: CLAUDE.md uses @ imports for README and dynamically includes project configs (package.json, Cargo.toml, etc.)
• Terse output style: Minimal, efficient responses without bloat

FAQ

Yes. It only creates config files, never modifies your code. Each file operation uses SHA256 checksums and creates timestamped backups.

# If something goes wrong, backups are here:
ls .create-claude-backup-*

Delete the config files:

rm -rf .claude CLAUDE.md

Your original code stays untouched.

• Node.js 18+
• Claude Code (the CLI tool)

That's it. No global installs, no dependencies.

It auto-detects:

• Formatters: Prettier, ESLint, Biome, dprint
• Package managers: npm, yarn, pnpm, bun
• Languages: JavaScript, TypeScript, Python, Go, Rust
• Frameworks: React, Vue, Next.js, etc.

Can't find your tool? It falls back to sensible defaults.

Creates 20 files in total:

.claude/
├── settings.local.json     # Permissions, tool detection
├── hooks/
│   ├── format.cjs         # Auto-format on save
│   ├── safety.cjs         # Block dangerous operations
│   └── session-end.cjs    # Cleanup on exit
├── agents/
│   ├── pre-commit.md      # Ruthless validation
│   ├── refactor.md        # Complexity reduction
│   └── debugger.md        # Root cause analysis
├── commands/
│   ├── commit.md          # Git commits with Haiku
│   ├── explain.md         # Code explanations
│   ├── fix.md             # Structured fixes
│   ├── optimize.md        # Performance improvements
│   ├── pr.md              # Pull request creation
│   ├── review.md          # Brutal code reviews
│   ├── test.md            # Test runner
│   └── validate.md        # Lint, typecheck, format
├── scripts/
│   ├── statusline.cjs         # Git status in prompt
│   ├── statusline-git.cjs     # Git operations helper
│   └── statusline-detect.cjs  # Framework detection helper
└── output-styles/
    └── terse.md                # Minimal output style

CLAUDE.md                   # Project-specific instructions

Security

This project follows security best practices:

• All dependencies are audited and kept up-to-date
• Code is scanned with CodeQL and other security tools
• OpenSSF Scorecard certified
• Signed releases with build provenance

Report security issues: SECURITY.md

Contributing

Contributions welcome! Please read SECURITY.md first, then:

1. Fork the repo
2. Create a feature branch
3. Run npm run validate before committing
4. Submit a pull request

Links

Issues • Changelog • Claude Code Docs • Security

License

MIT © RMNCLDYO