Get started
Generating a project takes one command. This page covers what the machine needs first, what the CLI asks, and what arrives.
Check the machine
Prumo needs Node 22.17 or later and pnpm. Anything with an API also needs Docker, because the development database runs there. This command checks all of it and names whatever is missing.
npx @stjoseph/prumo doctorGenerate the project
It asks what to build, writes the project into my-app/, runs git init and installs. Nothing is committed, so the first commit is yours and its diff shows everything Prumo wrote.
npx @stjoseph/prumo new my-appAnswer without a terminal
Every question has a flag. More than one type makes a workspace; a single type needs --alone or --monorepo to say how it is laid out.
npx @stjoseph/prumo new my-app --types api,web --single-tenantCreate the database
Inside a project with an API, this creates the development database in Docker and writes its URL into .env. Once the database exists, prumo clean removes the setup the project needed only once.
prumo db
The flags
| Flag | What it answers |
|---|---|
| --types api,web,mobile,site | What the project contains. More than one type makes a workspace |
| --alone --monorepo | How a single type is laid out |
| --multi-tenant --single-tenant | Whether the application serves several tenants |
| --skip-install | Stops after writing the files |
What landed
| File | What it is |
|---|---|
| .prumo/ | The conventions, in nine areas. Only the areas the answers call for are copied |
| .prumo/INDEX.md | One line per document. Generated by the tool, and safe to regenerate |
| AGENTS.md | The pointer into .prumo/, read by Codex, Cursor, Copilot, Gemini CLI and others |
| CLAUDE.md | An @AGENTS.md import, for Claude Code |