How iepathos/claudeforge works
ClaudeForge is a CLI project scaffolder. Users select a language and project name; the runtime resolves a registered template, fetches or reuses its cached repository, copies and customizes files, then initializes and commits a Git repository in the new project. The CLI also lists templates, refreshes cached templates, and reports version information. The workflow wiring is supported by the sampled entry point, loader, and processor; unsampled implementation details are not expanded.
Main entry points: loader.rs Template loader · processor.rs Project creation · main.rs Command dispatch · mod.rs Git operations
Components 15
CLI commands
- Command dispatch
src/main.rs - Command arguments
src/cli.rs - Version output
src/main.rs
Template management
- Template loader
src/template/loader.rs - Built-in registry
src/template/registry.rs - Template rules
src/template/mod.rs - Template cache
Project generation
- Project creation
src/template/processor.rs - Filesystem utilities
src/utils/fs.rs
Configuration and Git
- User configuration
src/config/mod.rs - Git operations
src/git/mod.rs
Other components
- CLI user
- Local filesystem
- Git repositories
- Generated project
Connections 23
- CLI user → Command arguments: provides command
- Command arguments → Command dispatch: dispatches
- Command dispatch → Git operations: checks availability
- Command dispatch → Project creation: creates project
- Command dispatch → Template loader: lists templates
- Command dispatch → Template loader: updates cache
- Command dispatch → Version output: prints version
- Template loader → User configuration: loads settings
- Template loader → Built-in registry: loads registry
- Built-in registry → Template rules: defines rules
- Template loader → Template cache: checks cache
- Template loader → Git operations: clones templates
- Git operations → Git repositories: accesses repositories
- Template loader → Local filesystem: manages cache
- Project creation → Template loader: resolves template
- Template loader → Project creation: returns template path
- Project creation → Template rules: reads customization rules
- Project creation → Filesystem utilities: copies template files
- Filesystem utilities → Local filesystem: reads and writes
- Project creation → Local filesystem: customizes files
- Project creation → Git operations: initializes and commits
- Git operations → Generated project: creates repository
- Project creation → Generated project: writes scaffold