akua init

Shipped

Scaffold a new package or workspace.

akua init [name] [flags]

Creates a directory with:

package.k — typed KCL Package definition
inputs.example.yaml — sample input
.akua/ — metadata + lockfile location
README.md — minimal docs stub

Flags

flag	description
`--template=<name>`	use a template (see `akua init --list-templates`)
`--package-name=<name>`	name for the Package (defaults to directory name)
`--no-git`	skip `git init`
`--list-templates`	list available templates

Templates

app — single-service app (default)
app-with-db — app + managed Postgres
umbrella — multi-service composition
platform-std — platform-team-published reusable package
empty — bare package.k with a minimal schema

Exit codes

0 success, 1 if target directory exists and is non-empty.

JSON output

{
  "name": "my-pkg",
  "path": "/absolute/path/my-pkg",
  "template": "app",
  "files": ["package.k", "inputs.example.yaml", ".akua/", "README.md"]
}