@tile/cli

The unified, agent-friendly CLI for Tile apps — source (init/pull/save), Live Layer (remote config), native builds, OTA code-push, and integrations.

Install

npm i -g @tile/cli
tile login          # authenticate against the Tile gateway
tile app list       # confirm you're connected

Local vs prod (one knob)

The CLI talks to the Tile gateway over HTTP. It defaults to the hosted gateway, so a published install works out of the box. Point it anywhere with a single env var:

export TILE_API_URL=https://demo.tile.dev   # default (hosted) — no need to set
export TILE_API_URL=http://localhost:8080         # local dev stack

For local development, use the tile-dev wrapper installed by tile-dev-setup — it runs this same CLI from source and defaults TILE_API_URL to your local gateway, so it never collides with a globally-installed prod tile.

Where state lives

• ~/.config/tile/credentials.json — session token (written 0600, never logged).
• ~/.config/tile/config.json — the selected app (tile use).
• ~/.config/tile/projects.json — machine-local appId → repo path index, so tile save --app <id> and friends work from anywhere. See tile projects, tile path <id>, tile unlink <id>.
• tile.json (in each repo) — the committed identity ("what app is this folder?").

Common commands

tile init --name "My App"     # create a Tile app + scaffold it locally
tile pull                     # fetch an app's files into the cwd
tile save                     # store the local files as a new version
tile projects                 # every app linked to a local repo on this machine
tile live-layer set k=v       # remote config / feature flags
tile build create --platform android
tile ota deploy               # ship a JS-only update

Run tile guide for the full lifecycle, tile <command> --help for details, and add --json to any command for machine-readable output.