projectos

Contract-first, LLM-optimized monorepo scaffold. Types defined once in Zod, derived everywhere.

The pos CLI — scaffold, codegen, validate, and manage type-safe projectOS projects.

Install

npm install -g projectos
# or
pnpm add -g projectos

Requires Node.js >=22.0.0.

Usage

pos init           # Scaffold a new projectOS project
pos codegen        # Run the codegen pipeline (Zod → JSON Schema → SDK)
pos validate       # Type-check the project
pos dev            # Start the daemon with codegen + validation services
pos manifest       # Regenerate the projectos.manifest.json file
pos daemon         # Manage the background daemon
pos version        # Print version
pos --help         # Full help

Architecture

projectos is a single, self-contained CLI. Under the hood it bundles:

• Contracts — Zod schemas as the single source of truth
• Codegen — Zod → JSON Schema → SDK barrel pipeline
• IO — Result monad, structured errors, typed config, logger
• CLI Kernel — Daemon runtime, services, IPC, Citty integration

All of these are wrapped behind the pos command. Only this single package is published to npm.

Versioning

This project uses Calendar Versioning (YYYY.M.MICRO) enforced via VersionGuard, and documentation quality is enforced via forge-ts.

Links

• Repository: https://github.com/kryptobaseddev/projectOS
• Issues: https://github.com/kryptobaseddev/projectOS/issues
• Changelog: CHANGELOG.md

License

MIT © kryptobaseddev