ubox-init

Scaffolds a new Ubox experience directory, downloads the latest library docs and agent skills from GitLab, and writes a pre-filled agent config file.

By default targets Claude Code (CLAUDE.md + .claude/commands/). Pass --gemini to target Gemini CLI (GEMINI.md + .agent/skills/) instead.

Requires Node.js 18+. No external dependencies.

Usage

npx @ubox-tools/ubox-init [--gemini] <name> [theme]

Arguments

| Argument | Required | Description | |---|---|---| | name | Yes | Experience name, used as the directory name. Quoted strings with spaces are used as-is; single words are converted to Title Case. | | theme | No | One-sentence description of what the experience does. Defaults to "A Ubox interactive experience: <name>." |

Options

| Option | Description | |---|---| | --gemini | Target Gemini CLI instead of Claude Code. Writes GEMINI.md and installs skills to .agent/skills/. | | -h, --help | Show usage help. |

Examples

# Claude Code (default)
npx @ubox-tools/ubox-init "Slide Puzzle" "A Kinect-controlled sliding puzzle game."

# Gemini CLI
npx @ubox-tools/ubox-init --gemini "Slide Puzzle" "A Kinect-controlled sliding puzzle game."

What gets created

Claude Code (default):

<name>/
├── CLAUDE.md                      pre-filled with project name, theme, and doc links
├── assets/
├── apps/
├── .claude/
│   └── commands/
│       └── build-xperience.md     downloaded from GitLab
└── docs/
    ├── Ubox.md                    downloaded from GitLab
    ├── ubox-machine.md            downloaded from GitLab
    ├── ubox-human.md              downloaded from GitLab
    └── ubox-data-xpace.md         downloaded from GitLab

Gemini CLI (--gemini):

<name>/
├── GEMINI.md                      pre-filled with project name, theme, and doc links
├── assets/
├── apps/
├── .agent/
│   └── skills/
│       └── build-xperience/
│           └── SKILL.md           downloaded from GitLab
└── docs/
    ├── Ubox.md                    downloaded from GitLab
    ├── ubox-machine.md            downloaded from GitLab
    ├── ubox-human.md              downloaded from GitLab
    └── ubox-data-xpace.md         downloaded from GitLab

Files are downloaded fresh from the GitLab repo each time, so the project always starts with the latest docs and skills.