CLI

The app CLI

Every endpoint in these docs is scriptable from one small binary. The CLI shares keys with the API and web app, streams chat, deploys apps and sites, drives coding agents, and mirrors the gh command layout for repos, issues, PRs, and releases. Any command takes --json; anything without a dedicated command is reachable via app api. The full command reference lives at /cli.

Core commands

app loginauthOpen app.nz in the browser, authorize with PKCE, and save the scoped login; app whoami verifies.

app apps deploy [dir]hostingPackage + build + release an appnz.yaml app (static or server runtime) at <name>.app.nz.

app apps logs <slug>hostingBuild and runtime logs for the latest (or a given) deploy.

app apps marketplace [query]hostingBrowse apps and games built on or showcased by app.nz.

app apps publish [slug] --url <url>hostingInstantly enrich a hosted app card or publish an external community app with automatic OG metadata discovery.

app sites deploy <slug> <dir>hostingMirror a directory of static files to a hosted site.

app agent run --prompt "..." --repo o/nagentsLaunch a cloud coding agent; get/list/cancel manage tasks.

app chat "..." [--web] [--deep]modelsStreamed chat through the gateway; --model pins a route.

app api <METHOD> <path> [json]escape hatchCall any documented endpoint directly.

Install, build with an agent, deploy a game

curl -fsSL https://app.nz/cli.sh | sh
app login

# hand the build to a cloud agent
app agent run --prompt "build a neon snake HTML5 game" --repo you/neon-snake

# pull the agent's files, then ship to https://neon-snake.app.nz
app agent apply <task-id> --dir ./neon-snake
app apps deploy ./neon-snake