pos

name	pos
description	ProjectOS CLI — scaffold, codegen, validate type-safe monorepo projects
version	2026.4.1
triggers	["create a new project","scaffold project","run codegen","validate types","start dev daemon"]

pos

ProjectOS CLI for scaffolding and managing contract-first, type-safe monorepo projects.

Prerequisites

• Node.js >= 20
• pnpm >= 9

Commands

• pos init <name> — Scaffold a new projectOS project
• pos codegen — Run Zod -> JSON Schema -> SDK codegen pipeline
• pos validate — Type-check the project
• pos dev — Start daemon with codegen and validation services
• pos manifest — Regenerate projectos.manifest.json
• pos daemon start|stop|status — Manage the background daemon
• pos version — Print version

Quick Start

pos init my-app --type api-server --domains users,products --json
cd my-app && pnpm install && pnpm build

Agent Guidance

• Always use --json for machine-readable output
• All flags are passable non-interactively (zero prompts needed)
• Exit codes: 0=success, 1=error, 2=validation, 3=daemon-not-running, 4=timeout
• pos validate --json returns structured type errors for self-correction