---
title: "ralphy new"
description: "Create a new project under <workspace>/projects/<id>/ with a canonical layout. Lightweight on-ramp — pass a brief to seed BRIEF.md or just --id <slug> for an em"
---

{/* Auto-generated — edit `cli/commands/<verb>.ts` instead. Regenerate via `bun run docs:cli`. */}

## Summary

```bash
ralphy new [options] [brief...]
```

**Common flags**

| Flag | Description |
|---|---|
| `--id <slug>` | Project id slug (default: derived from brief or YYMMDD-HHMMSS) |
| `--name <name>` | Display name (default: title-cased id) |
| `--brand <id>` | Brand id (registry lookup) |

**Example**

```bash
ralphy new "Spring 2026 ad for Acme dental floss"
```

<Expandable title="Full reference">

**Flags**

| Flag | Description |
|---|---|
| `--id <slug>` | Project id slug (default: derived from brief or YYMMDD-HHMMSS) |
| `--name <name>` | Display name (default: title-cased id) |
| `--brand <id>` | Brand id (registry lookup) |
| `--persona <id>` | Persona id (registry lookup) |
| `--template <id>` | Template id |
| `--platform <platform>` | Target platform (default: "tiktok") |
| `--aspect-ratio <ratio>` | Aspect ratio (default: "9:16") |
| `--duration <seconds>` | Target duration in seconds |
| `-h, --help` | display help for command |

**All examples**

```bash
ralphy new "Spring 2026 ad for Acme dental floss"
ralphy new --id summer-launch-001
ralphy new "office-set walkthrough" --id office-walk-001
```

</Expandable>
