// Contract-first, LLM-optimized monorepo scaffold Use when: (1) calling its 64 API functions, (2) configuring projectos-monorepo, (3) understanding its 62 type definitions, (4) working with its 1 classes, (5) user mentions "projectos-monorepo" or asks about its API.
The pos CLI — scaffold, codegen, validate, and manage type-safe projectOS projects Use when: (1) running pos CLI commands, (2) calling its 14 API functions, (3) understanding its 1 type definitions, (4) user mentions "projectos", "pos", "cli", "scaffold", "codegen", (5) user mentions "projectos" or asks about its API.
ProjectOS CLI — scaffold, codegen, validate type-safe monorepo projects
| name | SKILL-projectos-monorepo |
| description | Contract-first, LLM-optimized monorepo scaffold Use when: (1) calling its 64 API functions, (2) configuring projectos-monorepo, (3) understanding its 62 type definitions, (4) working with its 1 classes, (5) user mentions "projectos-monorepo" or asks about its API. |
Contract-first, LLM-optimized monorepo scaffold
npm install projectos-monorepo
const paths = resolveAppPaths('myapp');
console.log(paths.data); // ~/.local/share/myapp
| Function | Description |
|---|---|
createFileWriter() | Create a FileWriter rooted at rootDir. |
capitalize() | |
entityName() | Derive singular entity name from a domain name (e.g., "thoughts" - "Thought"). |
schemaFileName() | Derive schema filename from domain (e.g., "thoughts" - "thought"). |
generateDomainSchema() | Generate a Zod schema file + barrel for a domain. Produces: domain/entity.schema.ts and domain/index.ts |
generateContractsIndex() | Generate the contracts barrel index that re-exports all domains. |
generatePackage() | Generate a workspace package (package.json + tsconfig.json). |
generateRouteFile() | Generate a Hono CRUD route file backed by Drizzle. |
generateApiEntry() | Generate the Hono API entry point. |
generateRootConfigs() | Generate all root config files (tsconfig, turbo, biome, gitignore, etc). |
generateAgentsMd() | Generate AGENTS.md with full project documentation. |
generateManifest() | Generate the LLM-readable project manifest. |
generateDatabasePackage() | Generate the full database package with Drizzle ORM + SQLite. |
generateFrontendPackage() | Generate a full SvelteKit 5 + DaisyUI frontend package. |
resolveAppPaths() | Resolve platform-specific application paths for the given app name. |
| ... | 49 more — see API reference |
import type { ConfigOptions } from "projectos-monorepo";
const config: Partial<ConfigOptions> = {
// The configuration namespace name, used to derive the default env prefix.
name: "...",
// The Zod schema used to validate the merged configuration.
schema: { /* ... */ },
// Default values to use when environment variables are not set.
defaults: { /* ... */ },
// The prefix for environment variable names (e.g. `'APP'` maps `dbHost` to `APP_DB_HOST`).
envPrefix: "...",
// A custom environment variable source to read from instead of `process.env`.
env: { /* ... */ },
};
See references/CONFIGURATION.md for full details.
FileWriter — Tracked file writer that creates parent dirs and records all written paths.AppPaths — XDG-compliant application filesystem paths.ShutdownHandler — Async callback invoked when a termination signal is received.PidManager — Manages a PID file to ensure single-instance daemon execution.ShutdownStep — A named cleanup step executed during graceful shutdown.ShutdownController — Orchestrates an ordered sequence of shutdown steps.ServiceContext — Runtime context provided to each service during initialization.ServiceCommand — A command exposed by a service for remote invocation via the transport layer.Service — Lifecycle interface for a managed daemon service.ServiceRegistry — Central registry for managing service lifecycle, routing, and health reporting.