Quick Start

Start with regular mode:

cnos init
cnos value set app.name demo
cnos value set server.port 3000
cnos read value.app.name
cnos build env --profile local --to .env.local
cnos run -- node server.js

That gives you one flat .cnos/ tree and profiles.default: local.

In app code:

import cnos from '@kitsy/cnos';

await cnos.ready();
console.log(cnos('value.app.name'));

When the repo grows into multiple apps or packages, convert it instead of duplicating .cnos:

cnos workspace enable
cnos workspace add main --package-root apps/main
cnos workspace add insights --package-root apps/insights
cnos workspace list

If the repo still expects env files, keep CNOS as the source of truth and generate them:

cnos build env --profile local --to .env.local
cnos dev env --profile local --to .env.local -- pnpm dev