init

name	init
description	Scaffold new Bombshell project from bombshell-dev/template via giget. Replaces $name placeholder in package.json and README.md. Outputs to .temp/. Use when creating a new package in the Bombshell ecosystem.
metadata	{"type":"core","library":"@bomb.sh/tools","library_version":"0.6.0","sources":["bombshell-dev/tools:src/commands/init.ts"]}

Init

Scaffolds a new Bombshell project from the bombshell-dev/template GitHub template.

Setup

pnpm run init -- my-project

How It Works

pnpm run init runs bsh init which:

1. Clones gh:bombshell-dev/template via giget
2. Replaces $name placeholder in package.json and README.md with the project name
3. Outputs to .temp/ directory

Arguments

• First positional arg: project name
• If no name is provided, defaults to the parent directory name

pnpm run init -- my-project    # Creates .temp/my-project
pnpm run init                   # Uses parent directory name

Common Mistakes

MEDIUM: Manually scaffolding project structure

The template includes all Bombshell conventions (package.json scripts, tsconfig, etc.). Don't create these by hand.

# Wrong
mkdir my-project
cd my-project
npm init -y
# ... manually adding scripts, configs, etc.

# Correct
pnpm run init -- my-project

See Also

• lifecycle/SKILL.md — After init, enter the lifecycle workflow