Command Reference
Full reference for all Nativeblocks CLI commands and flags.
Installation
curl -fsSL https://nativeblocks.io/download/cli/installer.sh | bash
You can always find all commands with the help command:
nativeblocks help
Init
Initialize a new Nativeblocks project scaffold. Authenticates, sets up organization and project, pulls installed integrations, and creates sample frames.
nativeblocks init
Auth
Multiple accounts are supported (e.g. personal and company). Each login adds an account; tokens are kept per email. Every project remembers which account it uses. With a single account it is used automatically; with several, pick one per project via nativeblocks auth switch.
Log in with email OTP
nativeblocks auth login
Authenticate with a JWT access token
nativeblocks auth token "your.jwt.token"
List accounts
nativeblocks auth list
Switch account
Pins an account to the current project (run inside an initialized project).
| Flag | Description |
|---|---|
--email | Account email. Skips interactive selection (for CI/CD). |
nativeblocks auth switch
nativeblocks auth switch --email "[email protected]"
Log out
| Flag | Description |
|---|---|
--email | Account email. Skips interactive selection. |
nativeblocks auth logout
Organization
Create organization
| Flag | Description |
|---|---|
--name | Organization name |
nativeblocks organization create --name "My Organization"
Select organization
| Flag | Description |
|---|---|
--id | Organization ID. Skips interactive selection (for CI/CD). |
nativeblocks organization set
nativeblocks organization set --id "your-org-id"
Show current organization
nativeblocks organization get
Project
Create project
| Flag | Description |
|---|---|
--name | Project name |
nativeblocks project create --name "My Project"
Select project
Saves the selection to .nativeblocks/ in the current directory.
| Flag | Description |
|---|---|
--id | Project ID. Skips interactive selection (for CI/CD). |
nativeblocks project set
nativeblocks project set --id "your-project-id"
Show current project
nativeblocks project get
Integration
List integrations
| Flag | Short | Description |
|---|---|---|
--platform | -p | Platform support filter (e.g. ANDROID, IOS) |
--kind | -k | Integration kind (BLOCK or ACTION) |
nativeblocks integration list -p ANDROID -k BLOCK
Sync integration
Upload a local integration to the server.
| Flag | Short | Description |
|---|---|---|
--directory | -d | Directory containing integration.json |
nativeblocks integration sync -d /path/to/integration
Get integration
Download an integration from the server to a local directory.
| Flag | Short | Description |
|---|---|---|
--integrationId | -i | Integration ID |
--directory | -d | Directory to save integration files |
nativeblocks integration get -i "2222-2222-2222-2222" -d /path/to/save
Frame
Create frame
Generate a placeholder frame file for the given name and platform. Reads the project language automatically from .nativeblocks/.
| Flag | Short | Description |
|---|---|---|
--name | -n | Frame name (e.g. HomeScreen) |
--platform | -p | Target platform: ANDROID or IOS |
nativeblocks frame create --name HomeScreen --platform ANDROID
nativeblocks frame create -n Dashboard -p IOS
Deploy frame
Build a frame file (TypeScript, Kotlin, or Swift) and deploy it to the backend.
| Flag | Short | Description |
|---|---|---|
--file | -f | Frame file to deploy |
--watch | Watch for changes, re-deploy, and trigger hot-reload on connected devices | |
--log | Stream logs from connected SDK devices (requires --watch) | |
--tag | -t | Mark this deployment as a named version for release management (e.g. v1.0.0). Cannot be combined with --watch. |
--force | Skip confirmation prompts. For CI/CD pipelines. |
nativeblocks frame deploy -f ./src/welcome-android.ts
nativeblocks frame deploy -f ./src/welcome-android.kt --watch
nativeblocks frame deploy -f ./src/welcome-ios.swift --watch
nativeblocks frame deploy -f ./src/welcome-android.ts --watch --log
nativeblocks frame deploy -f ./src/welcome-android.ts --tag v1.0.0
nativeblocks frame deploy -f ./src/welcome-android.ts --tag v1.0.0 --force
Code Gen
Generate typed block and action classes from the installed integrations. Reads the language and options configured by nativeblocks init.
nativeblocks code-gen
AI
List skills
List available AI skills and supported agents.
nativeblocks ai skill list
Add skill
Install Nativeblocks skill files for your AI coding tool.
nativeblocks ai skill add
Update
Update the CLI to the latest version. Downloads the official installer and runs it, replacing the current binary in place.
nativeblocks update