cub new¶

Create a new project directory with git and cub initialized, ready for development.

Synopsis¶

cub new <directory>

Description¶

The new command bootstraps a complete project directory in one step. It combines directory creation, git init, and cub init into a single command.

Behavior by directory state:

State	Action
Directory doesn't exist	Create it, `git init`, `cub init`
Directory exists but empty	`git init`, `cub init`
Directory exists with files	Prompt for confirmation, then `cub init` only (skips `git init` if `.git/` present)

Arguments¶

Argument	Description
`directory`	Path to the project directory to create

Examples¶

Create a New Project¶

cub new my-app

Output:

Initialized git repository in /home/user/my-app
...cub init output...

Project ready at /home/user/my-app

Nested Directory¶

cub new projects/2026/my-api

Creates all parent directories as needed.

Existing Directory¶

cub new ~/existing-project

If the directory has files, you'll be prompted:

Directory '/home/user/existing-project' already has files. Run cub init there instead? [y/N]:

Exit Codes¶

Code	Meaning
`0`	Project created successfully (or user declined on existing directory)
`1`	Error (`git init` failed, `cub init` failed, or bash cub not found)

cub init - Initialize cub in an existing project
cub doctor - Diagnose configuration issues
cub run - Execute the task loop