CLI reference
synopkgland is the Developer Kit CLI (@synopackageland/cli). Skill Pack ships with the CLI — not a separate npm package.
Intended install: npm i -g @synopackageland/cli. Public npm may not be published yet.
The CLI walks up from the current working directory to find synology-app.yaml, or use --project <dir>.
| Command | Purpose |
|---|---|
init -t hello-web|hello-files|compose-import | Create minimal Compose and App Contract from a template. |
inspect | List published ports, data paths, and risks from existing Compose; suggest admin* metadata. |
dev | Run Compose locally with mock Broker, fake user, and fake file tree. |
validate | Check schema, Compose cross-references, security policy, and compatibility profile. |
test | Run contract tests and local Compose readiness; optional --host smoke after deploy. |
deploy --host <nas> | Inner Loop Deploy — generate thin SPK, DSM authorization, Local Attestation, Personal App. |
info | Show Package Identity, dev vs production instance, DSM Open URL, readiness summary. |
log | Follow container logs; masked diagnostics on failure. |
build-spk | Produce a deterministic local thin SPK (not a Curated release). |
publish | Open or update a Community Repository Pull Request; does not sign Curated releases. |
Typical flow
synopkgland init -t hello-web
synopkgland dev
synopkgland validate
synopkgland test
synopkgland deploy --host <nas>
synopkgland info
synopkgland log
synopkgland publish