@layers/amba

Amba is the agent-native backend-as-a-service for mobile and web apps. This package is the amba command-line interface.

Install

npm install -g @layers/[email protected]

…or run on demand:

npx @layers/amba init

Requires Node.js 22 or newer.

Agent mode (recommended)

For AI coding agents (Claude Code, Cursor, Windsurf): one command, no browser, no prompts.

npx @layers/amba init --sandbox

This signs up an agent-mode developer account, provisions a project, writes .env.local + AMBA.md, auto-wires mcpServers.amba into every MCP client config it finds on disk, and installs the /amba-build Claude Code skill at .claude/skills/amba-build/SKILL.md.

After restarting your MCP client, paste:

/amba-build <design-url-or-description>

…to scaffold a full Expo app with Amba as the only backend. The skill fetches the canonical prompt from https://docs.amba.dev/docs/prompts/expo-build at invocation time and falls back to an inlined snapshot when offline. Use --no-skills to skip the skill install.

Configure + first call

amba init              # mint a personal project and write .amba/ config
amba login             # browser-based auth (skip with --token / AMBA_PAT)
amba projects list

Track your first event from the CLI:

amba events track app_opened --prop source=cli

Common commands

amba functions deploy ./functions/hello.ts
amba collections create messages --field user_id:uuid --field body:text
amba types generate                       # emits .amba/types.d.ts
amba secrets set OPENAI_KEY --function hello --from-stdin
amba sites deploy ./out --name marketing

Headless / CI

Pass a Personal Access Token via --token <pat> or AMBA_PAT to skip the browser login.

Docs

Full reference: https://docs.amba.dev/cli.

License

Apache-2.0