https://github.com/ramonclaudio/create-claude
Claude Code setup that just works. Bootstrap every project with agents, hooks, commands, and smart permissions. One command, zero headaches.
https://github.com/ramonclaudio/create-claude
anthropic anthropic-claude anthropic-claude-ai claude claude-ai claude-code claude-code-commands claude-code-hooks claude-code-mcp claude-code-memory claude-code-sdk claude-code-subagents claudecode cli npm scaffolding typescript
Last synced: 16 days ago
JSON representation
Claude Code setup that just works. Bootstrap every project with agents, hooks, commands, and smart permissions. One command, zero headaches.
- Host: GitHub
- URL: https://github.com/ramonclaudio/create-claude
- Owner: ramonclaudio
- License: mit
- Created: 2025-08-26T12:10:13.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-12-15T06:21:53.000Z (2 months ago)
- Last Synced: 2025-12-21T21:39:18.607Z (about 2 months ago)
- Topics: anthropic, anthropic-claude, anthropic-claude-ai, claude, claude-ai, claude-code, claude-code-commands, claude-code-hooks, claude-code-mcp, claude-code-memory, claude-code-sdk, claude-code-subagents, claudecode, cli, npm, scaffolding, typescript
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/create-claude
- Size: 251 KB
- Stars: 5
- Watchers: 0
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Citation: CITATION.cff
- Codeowners: CODEOWNERS
- Security: SECURITY.md
- Support: SUPPORT.md
Awesome Lists containing this project
README
# create-claude
Claude Code setup that just works. Bootstrap every project with agents, hooks, commands, and smart permissions. One command, zero headaches.
[](https://www.npmjs.com/package/create-claude)
[](https://www.npmjs.com/package/create-claude)
[](https://www.npmjs.com/package/create-claude)
[](https://opensource.org/licenses/MIT)
## Quick Start
```bash
npm create claude
```
*Adds **local** Claude Code config files to your project. ZERO dependencies, ZERO overhead.*
## Installation Options
### Package Managers
```bash
npm create claude # npm
pnpm create claude # pnpm
bun create claude # bun
yarn create claude # yarn
```
### Flags
```bash
npm create claude --dry-run # Preview files
npm create claude --help # All options
```
### Shortcuts
```bash
cld # Short alias
npx cld # Via npx
```
## Programmatic Usage
### Installation
```bash
npm i create-claude
```
### Usage
```typescript
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
Is it safe to run?
Yes. It only creates config files, never modifies your code. Each file operation uses SHA256 checksums and creates timestamped backups.
```bash
# If something goes wrong, backups are here:
ls .create-claude-backup-*
```
How do I remove it?
Delete the config files:
```bash
rm -rf .claude CLAUDE.md
```
Your original code stays untouched.
What are the requirements?
- Node.js 18+
- [Claude Code](https://claude.ai/code) (the CLI tool)
That's it. No global installs, no dependencies.
Does it work with my tools?
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.
What files does it create?
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](SECURITY.md)
## Contributing
Contributions welcome! Please read [SECURITY.md](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**](https://github.com/RMNCLDYO/create-claude/issues) • [**Changelog**](https://github.com/RMNCLDYO/create-claude/blob/main/CHANGELOG.md) • [**Claude Code Docs**](https://docs.anthropic.com/en/docs/claude-code) • [**Security**](SECURITY.md)
## License
MIT © [RMNCLDYO](https://github.com/RMNCLDYO)