ClaudeForge CLI

A command-line tool that streamlines the creation of new projects optimized for development with Claude Code. ClaudeForge provides a simple interface to scaffold projects in multiple languages using curated templates that include comprehensive AI development guidelines, proper gitignore configurations, and best practices baked into the project structure.

🚀 Quick Start

Installation

# Install from crates.io (when published)
cargo install claudeforge

# Or build from source
git clone https://github.com/iepathos/claudeforge.git
cd claudeforge
cargo build --release

Create Your First Project

# Create a new Rust project
claudeforge new rust my-awesome-project

# Create a Go project in a specific directory
claudeforge new go my-service --directory ~/projects

# Skip confirmation prompts
claudeforge new rust my-project --yes

📋 Commands

new - Create a new project

claudeforge new <LANGUAGE> <NAME> [OPTIONS]

# Arguments:
#   <LANGUAGE>  Language template to use (rust, go)
#   <NAME>      Project name

# Options:
#   -d, --directory <DIR>  Target directory (defaults to current directory)
#   -y, --yes             Skip interactive prompts

list - List available templates

claudeforge list

# Shows all available templates with descriptions

update - Update cached templates

claudeforge update

# Updates all templates to their latest versions

version - Show version information

claudeforge version

🎯 Features

• Multi-language support: Currently supports Rust and Go templates
• AI-optimized templates: Pre-configured with CLAUDE.md guidelines
• Git integration: Automatically initializes clean git repositories
• Template customization: Replaces project placeholders with your values
• Offline support: Caches templates locally for faster project creation
• Cross-platform: Works on macOS, Linux, and Windows

📁 Project Structure

ClaudeForge creates projects with the following structure:

my-project/
├── src/                    # Source code
├── tests/                  # Test files
├── CLAUDE.md              # Claude Code development guidelines
├── .gitignore             # Language-specific gitignore
├── README.md              # Project documentation
├── Cargo.toml             # Rust: Project manifest
└── go.mod                 # Go: Module definition

🛠️ Development

Prerequisites

• Rust 1.70.0 or later
• Git (for repository operations)

Building from Source

# Clone the repository
git clone https://github.com/iepathos/claudeforge.git
cd claudeforge

# Build the project
cargo build --release

# Run tests
cargo test

# Install locally
cargo install --path .

Development Commands

# Run with just
just fmt      # Format code
just lint     # Run clippy
just test     # Run all tests
just build    # Build release binary

# Or use cargo directly
cargo fmt
cargo clippy -- -D warnings
cargo test
cargo build --release

🤖 Claude Code Integration

Each generated project includes a comprehensive CLAUDE.md file that provides:

• Architecture guidelines: Error handling, concurrency patterns, and configuration management
• Code style standards: Documentation, logging, and testing requirements
• Development patterns: Best practices and anti-patterns specific to each language
• Example prompts: How to effectively communicate with Claude for various tasks

Template Features

Rust Templates:

• Pre-configured Cargo.toml with common dependencies
• Async/await support with tokio
• Comprehensive error handling with anyhow
• Testing setup with unit and integration tests
• CLI argument parsing with clap

Go Templates:

• Modern Go module structure
• Context-aware error handling
• Structured logging setup
• Testing patterns and examples
• CLI framework integration

📦 Template Registry

ClaudeForge uses a registry system to manage templates:

# Built-in templates
[[templates]]
name = "rust-claude-code"
language = "rust"
repository = "https://github.com/iepathos/rust-claude-code"
description = "Comprehensive Rust starter template with Claude Code guidelines"

[[templates]]
name = "go-claude-code"
language = "go"
repository = "https://github.com/iepathos/go-claude-code"
description = "Go project template optimized for Claude Code development"

🔧 Configuration

Global Configuration

Create ~/.config/claudeforge/config.toml:

[defaults]
author_name = "Your Name"
author_email = "your.email@example.com"
default_directory = "~/projects"

[templates]
cache_directory = "~/.cache/claudeforge"
auto_update = true
update_interval_days = 7

Template Customization

Templates support placeholder replacement:

• {{PROJECT_NAME}} - Project name
• {{AUTHOR_NAME}} - Author name from git config
• {{AUTHOR_EMAIL}} - Author email from git config
• {{CURRENT_DATE}} - Current date (YYYY-MM-DD)

🚀 Example Usage

Creating a Rust Web Service

claudeforge new rust my-web-service
cd my-web-service

# The project is ready for Claude Code development
claude code .

Creating a Go CLI Tool

claudeforge new go my-cli-tool --directory ~/work/projects
cd ~/work/projects/my-cli-tool

# Start developing immediately
go run main.go

🔍 Troubleshooting

Common Issues

Template not found:

# Update template cache
claudeforge update

# List available templates
claudeforge list

Git not found:

# Install git on your system
# macOS: brew install git
# Ubuntu: sudo apt install git
# Windows: Download from git-scm.com

Permission denied:

# Ensure you have write permissions to the target directory
chmod +w target-directory

🤝 Contributing

We welcome contributions to ClaudeForge! Please see our contribution guidelines:

1. Fork the repository
2. Create a feature branch
3. Make your changes following the guidelines in CLAUDE.md
4. Ensure all tests pass: just test
5. Submit a pull request

Adding New Templates

To add support for a new language:

1. Create a template repository with the language structure
2. Add template configuration to src/config/templates.toml
3. Test the template creation process
4. Update documentation

📝 License

MIT License - see LICENSE file for details.

🎯 Roadmap

• Additional language templates (Python, JavaScript, TypeScript)
• Custom template support from local directories
• Template versioning and rollback
• Interactive template selection
• Plugin system for custom processors
• Integration with popular project hosting platforms

Happy coding with ClaudeForge! 🔨🤖

Create better projects faster with AI-optimized templates and get straight to building amazing software.