WAID

Install the CLI

Everything you do with WAID goes through the waid command-line tool. Install it, then confirm your environment with waid doctor.

Install waid#

waid ships as a native installer for each platform. Your early-access onboarding includes the installer for your machine. Homebrew and npm packages are not available yet.

PlatformInstallerInstalls to
macOS (Apple Silicon)waid-<version>-macos-arm64.pkg/usr/local/bin/waid
macOS (Intel)waid-<version>-macos-x64.pkg/usr/local/bin/waid
Linuxwaid-<version>-linux-<arch>.deb/usr/bin/waid
Windowswaid_<version>_x64-setup.exe%LOCALAPPDATA%\waid
  • macOS: double-click the .pkg.
  • Linux: sudo apt install ./waid-<version>-linux-<arch>.deb
  • Windows: run the setup .exe; it adds waid to your user PATH.

Each installer puts waid on your PATH. Open a new terminal if the current one doesn't find it.

Verify the install:

bash
waid --help
waid version
waid help app
waid help service

Sign in to ICE#

Scaffolding, development, builds, and remote synchronization require an ICE session. Sign in through Splenta ID and check the shared CLI/Studio session:

bash
waid login --env local
waid session --json

Use --env staging or --env prod for a configured hosted environment, and --tenant <key> when selecting a tenant. Local app/service MCP generation does not require login. See the CLI reference.

Prerequisites#

You only need the toolchain for what you actually build:

  • Node.js + npm: required for every project. Your app is a standard Vite project, and WAID runs npm run build to produce the web bundle.
  • Android: the Android SDK (ANDROID_HOME / ANDROID_SDK_ROOT) and adb, to build and install Android apps.
  • iOS: Xcode and its command-line tools (macOS only).
  • Desktop: no extra setup beyond a working WAID install for most hosts.

The browser target needs no native toolchain; WAID still needs Node and an ICE session.

Check your setup#

bash
waid doctor                 # general environment health check
waid doctor android         # Android SDK / adb / connected devices
waid doctor ios-signing     # iOS signing: teams, provisioning profiles

Run waid doctor before your first native build to catch a missing SDK early.