Skip to content
Kitsy Docs Open CNOS

Your First Project

Your First Project

Create the project structure:

Terminal window
cnos init
cnos doctor

Add values:

Terminal window
cnos value set app.name my-service
cnos value set server.port 3000

Create a profile:

Terminal window
cnos profile create stage
cnos use --profile stage

Create a local vault and authenticate it:

Terminal window
cnos vault create default
cnos vault auth default
cnos secret set app.token --vault default

CNOS prompts for the secret with masked input when you omit the value, which keeps it out of shell history. For non-interactive scripts, pass the secret over --stdin.

If the project later becomes a monorepo, do not create a second .cnos. Convert the existing repo and add children:

Terminal window
cnos workspace enable
cnos workspace add api --package-root apps/api
cnos workspace add admin --package-root apps/admin