Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
70e9c29
feat: add debugger subagent for root cause analysis
ramonclaudio Sep 7, 2025
c196b1f
feat: add /commit slash command with Haiku model
ramonclaudio Sep 7, 2025
d4ce242
feat: add /explain slash command for code explanations
ramonclaudio Sep 7, 2025
ffe1066
feat: add /fix slash command for structured issue resolution
ramonclaudio Sep 7, 2025
a5fe61f
feat: add /optimize slash command for performance improvements
ramonclaudio Sep 7, 2025
7bff6a1
feat: add /pr slash command for pull request creation
ramonclaudio Sep 7, 2025
56abe6b
feat: add /review slash command for brutal code reviews
ramonclaudio Sep 7, 2025
f189bc6
feat: add session-end hook for cleanup on exit
ramonclaudio Sep 7, 2025
f6e68dd
refactor: enhance pre-commit agent with structured validation
ramonclaudio Sep 7, 2025
b82f8b5
refactor: enhance refactor agent with aggressive complexity reduction
ramonclaudio Sep 7, 2025
28d692d
feat: implement bypassPermissions mode with enhanced safety boundaries
ramonclaudio Sep 7, 2025
9853bf8
feat: add PROJECT_IMPORTS template variable for dynamic config inclusion
ramonclaudio Sep 7, 2025
7f9109f
refactor: enhance safety hook with permissive mode detection
ramonclaudio Sep 7, 2025
c816495
feat: enhance test command with pattern support
ramonclaudio Sep 7, 2025
16826a8
fix: update CLI to list all 20 created files
ramonclaudio Sep 7, 2025
8825a6c
fix: add all 20 files to validation list
ramonclaudio Sep 7, 2025
6a62baf
feat: add PROJECT_IMPORTS template variable generation
ramonclaudio Sep 7, 2025
3b548dd
feat: add PROJECT_IMPORTS to template validation
ramonclaudio Sep 7, 2025
aa5d762
feat: add PROJECT_IMPORTS to TemplateVariables interface
ramonclaudio Sep 7, 2025
b9b93b4
docs: update README with v0.1.9 features and remove emojis
ramonclaudio Sep 7, 2025
8b9c4c9
docs: add v0.1.9 changelog with all new features
ramonclaudio Sep 7, 2025
7e6263e
chore: bump version to 0.1.9
ramonclaudio Sep 7, 2025
074c6f1
chore: update auxiliary files for v0.1.9
ramonclaudio Sep 7, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -28,4 +28,7 @@ Thumbs.db
*.log

# local settings
!settings.local.json
/.claude
/CLAUDE.md
!skel/.claude
!skel/CLAUDE.md
39 changes: 39 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,44 @@ All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [0.1.9] - 2025-09-07

### Added

- **Enhanced Permission System**: Implemented `bypassPermissions` mode for maximum autonomy with safety guardrails
- **8 Custom Slash Commands**: Added `/commit`, `/explain`, `/fix`, `/optimize`, `/pr`, `/review`, `/test`, `/validate` with proper frontmatter and argument support
- **3 Specialized Subagents**: Pre-commit validator, code refactorer, and debugger with focused tool access
- **Session Lifecycle Hooks**: SessionEnd hooks for project context and cleanup
- **Bash Command Execution**: Added `!` prefix support in slash commands for dynamic git context
- **Import-based Memory**: CLAUDE.md now uses `@` imports for README and package.json references via `PROJECT_IMPORTS` template variable
- **Environment Variables**: Configured bash timeouts and working directory maintenance
- **Statusline Helper Scripts**: Added statusline-git.cjs and statusline-detect.cjs for modular statusline functionality
- **Template Variable**: Added `PROJECT_IMPORTS` to dynamically include project configuration files in CLAUDE.md

### Changed

- **Simplified Permissions**: Switched from explicit tool lists to `allow: ["*"]` with targeted deny/ask lists
- **Safety Hook Rewrite**: Enhanced with permissive mode detection and refined dangerous pattern matching
- **Terse Output Style**: Configured for minimal, efficient responses without bloat
- **Status Line**: Advanced implementation with git integration, framework detection, and color coding
- **Gitignore**: Fixed to properly track skel/.claude template files while ignoring local instances

### Improved

- **Subagent Formatting**: Added proper markdown headers and structure to pre-commit and refactor agents
- **Command Arguments**: Added `argument-hint` and `$ARGUMENTS` placeholders to relevant commands
- **Security Patterns**: Refined dangerous command detection to only block truly destructive operations
- **Delete Confirmations**: All delete operations now require explicit user confirmation
- **File Validation**: Updated init.ts to validate all 20 template files including new scripts and hooks
- **CLI Output**: Updated to display all 20 created files instead of subset

### Fixed

- **Hook Timeout**: Reduced safety hook timeout from 5 to 2 seconds for better responsiveness
- **Path Patterns**: Corrected permission patterns to use `//` for absolute paths and `~` for home directory
- **Template System**: Added PROJECT_IMPORTS to types.ts and template.ts for proper variable handling
- **Required Files**: Added statusline-git.cjs and statusline-detect.cjs to init.ts validation list

## [0.1.8] - 2025-09-06

### Enhanced
Expand Down Expand Up @@ -233,6 +271,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- Comprehensive test suite
- TypeScript support with strict configuration

[0.1.9]: https://github.com/RMNCLDYO/create-claude/compare/v0.1.8...v0.1.9
[0.1.8]: https://github.com/RMNCLDYO/create-claude/compare/v0.1.7...v0.1.8
[0.1.7]: https://github.com/RMNCLDYO/create-claude/compare/v0.1.6...v0.1.7
[0.1.6]: https://github.com/RMNCLDYO/create-claude/compare/v0.1.5...v0.1.6
Expand Down
4 changes: 2 additions & 2 deletions CITATION.cff
Original file line number Diff line number Diff line change
Expand Up @@ -29,5 +29,5 @@ keywords:
- "productivity"
license: MIT
license-url: "https://github.com/RMNCLDYO/create-claude/blob/main/LICENSE"
version: "0.1.8"
date-released: "2025-09-06"
version: "0.1.9"
date-released: "2025-09-07"
80 changes: 60 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,7 @@ Claude Code setup that just works. Bootstrap every project with agents, hooks, c

[![version](https://img.shields.io/npm/v/create-claude.svg?label=version&color=brightgreen)](https://www.npmjs.com/package/create-claude)
[![downloads](https://img.shields.io/npm/dm/create-claude.svg?label=downloads&color=blue)](https://www.npmjs.com/package/create-claude)
[![package size](https://img.shields.io/npm/unpacked-size/create-claude?label=package%20size&color=orange)](https://www.npmjs.com/package/create-claude)
[![node version](https://img.shields.io/node/v/create-claude?label=node%20version&color=forestgreen)](https://www.npmjs.com/package/create-claude)
[![build](https://github.com/RMNCLDYO/create-claude/workflows/CI/badge.svg?label=build&color=navy)](https://github.com/RMNCLDYO/create-claude/actions/workflows/ci.yml)
[![security](https://github.com/RMNCLDYO/create-claude/workflows/Security%20Scan/badge.svg?label=security&color=purple)](https://github.com/RMNCLDYO/create-claude/actions/workflows/security.yml)
[![openssf](https://www.bestpractices.dev/projects/11141/badge?label=openssf&color=gold)](https://www.bestpractices.dev/projects/11141)
[![package size](https://img.shields.io/npm/unpacked-size/create-claude?label=package%20size&color=yellow)](https://www.npmjs.com/package/create-claude)
[![license](https://img.shields.io/badge/license-MIT-red.svg)](https://opensource.org/licenses/MIT)

## Quick Start
Expand All @@ -17,11 +13,12 @@ Claude Code setup that just works. Bootstrap every project with agents, hooks, c
npm create claude
```

*Adds the **local** config files to your project. ZERO dependencies, ZERO overhead.*
*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
Expand All @@ -30,12 +27,14 @@ 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
Expand All @@ -44,11 +43,13 @@ npx cld # Via npx
## Programmatic Usage

### Installation

```bash
npm i create-claude
```

### Usage

```typescript
import { init } from 'create-claude';

Expand All @@ -57,14 +58,35 @@ await init('./my-project');

## Features

### Smart Configuration
- **Auto-detection**: Finds your package.json scripts, formatters, linters
- **Smart permissions**: Pre-approves safe operations, blocks dangerous ones
### 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

### Enhanced Workflow
- **Custom agents**: `/refactor` and `/validate` commands
- **Better statusline**: Shows Git branch, uncommitted changes
- **Format hooks**: Runs Prettier/ESLint/etc automatically
### 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

Expand All @@ -77,6 +99,7 @@ Yes. It only creates config files, never modifies your code. Each file operation
# If something goes wrong, backups are here:
ls .create-claude-backup-*
```

</details>

<details>
Expand Down Expand Up @@ -104,6 +127,7 @@ That's it. No global installs, no dependencies.
<summary><strong>Does it work with my tools?</strong></summary>

It auto-detects:

- **Formatters**: Prettier, ESLint, Biome, dprint
- **Package managers**: npm, yarn, pnpm, bun
- **Languages**: JavaScript, TypeScript, Python, Go, Rust
Expand All @@ -115,28 +139,44 @@ Can't find your tool? It falls back to sensible defaults.
<details>
<summary><strong>What files does it create?</strong></summary>

Creates 20 files in total:

```
.claude/
├── settings.local.json # Permissions, tool detection
├── hooks/
│ ├── format.cjs # Auto-format on save
│ └── safety.cjs # Block dangerous operations
│ ├── safety.cjs # Block dangerous operations
│ └── session-end.cjs # Cleanup on exit
├── agents/
│ ├── refactor.md # /refactor command
│ └── pre-commit.md # Git hook integration
│ ├── pre-commit.md # Ruthless validation
│ ├── refactor.md # Complexity reduction
│ └── debugger.md # Root cause analysis
├── commands/
│ ├── validate.md # /validate command
│ └── test.md # /test command
└── scripts/
└── statusline.cjs # Git status in prompt
│ ├── 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
```

</details>

## 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
Expand Down
4 changes: 2 additions & 2 deletions SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ We release patches for security vulnerabilities. Which versions are eligible for

**Please do not report security vulnerabilities through public GitHub issues.**

Instead, please report them via email to **hi@rmncldyo.com**.
Instead, please report them via email to **<hi@rmncldyo.com>**.

You should receive a response within 48 hours. If for some reason you do not, please follow up via email to ensure we received your original message.

Expand Down Expand Up @@ -53,4 +53,4 @@ We support safe harbor for security researchers who:
- Do not access, modify, or delete data belonging to others
- Contact us first before sharing details of any vulnerabilities with others

We will not pursue legal action against security researchers who follow these guidelines.
We will not pursue legal action against security researchers who follow these guidelines.
4 changes: 2 additions & 2 deletions SUPPORT.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ Before creating an issue, please:

## Commercial Support

For priority support, custom implementations, or consulting services, contact hi@rmncldyo.com.
For priority support, custom implementations, or consulting services, contact <hi@rmncldyo.com>.

## Contributing

Expand All @@ -58,4 +58,4 @@ We welcome contributions! See our [Contributing Guide](CONTRIBUTING.md) for deta

## Code of Conduct

This project follows our [Code of Conduct](CODE_OF_CONDUCT.md). Please read it before participating in our community.
This project follows our [Code of Conduct](CODE_OF_CONDUCT.md). Please read it before participating in our community.
22 changes: 11 additions & 11 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 3 additions & 3 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "create-claude",
"version": "0.1.8",
"version": "0.1.9",
"description": "Claude Code setup that just works. Bootstrap every project with agents, hooks, commands, and smart permissions. One command, zero headaches.",
"type": "module",
"sideEffects": false,
Expand Down Expand Up @@ -98,7 +98,7 @@
"preferGlobal": false,
"stability": "stable",
"devDependencies": {
"@types/node": "^20.19.11",
"typescript": "^5.3.0"
"@types/node": "^24.3.1",
"typescript": "^5.9.2"
}
}
Loading