Get started

Get started with the raw CLI

Install the matching CLI and run a local-first desktop app from your terminal.

Verified 16 October 2026

Use this path for direct control over setup and scaffolding. You can run it without an assistant, or add generated guidance for Claude Code, Codex, Cursor or OpenCode.

Check the required tools

Use Node.js 22.17 or newer and npm. The generated desktop project installs its own Electron and Pear runtime dependencies.

bash

$ node --version
npm --version

Install the matching CLI

Use 0.4.0-beta.1 for the maintained workflow. This candidate is not on npm yet. Build the pinned public source in a new folder with a macOS/Linux shell and a user-writable npm prefix; the older published 0.3.0 has a different command surface.

bash

$ git clone https://github.com/unstoppable-stack/unstoppable-dev.git unstoppable-cli-source
cd unstoppable-cli-source
git checkout 121cabca1ed2978f98ff1795cc6b87401889be9e
cd packages/cli
npm ci --ignore-scripts
mkdir -p ../../cli-artifacts
npm pack --pack-destination ../../cli-artifacts
npm install --global --prefix "$HOME/.local" ../../cli-artifacts/unstoppable-stack-cli-0.4.0-beta.1.tgz
export PATH="$HOME/.local/bin:$PATH"
cd ~
us --version

Create a workspace

This creates a workspace, not a runnable app. The command chooses no assistant; use --assistant claude or --assistant codex instead if you want generated project guidance.

bash

$ us init shop-workspace --assistant none --no-install
cd shop-workspace

Scaffold the app

The shop-starter child directory contains a minimal runnable app with peer networking and local Hyperbee storage. It does not include the Local Goods catalog or checkout.

bash

$ us scaffold app -p pear-desktop -n shop-starter

Install and run from the app folder

A desktop window should open. Keep this terminal open while the app is running.

bash

$ cd shop-starter
npm install
npm run dev

Verify persistence

Save an entry, close the app normally and start it again. The entry should remain. Local reads and writes should continue while offline; discovering and syncing with another peer requires connectivity.

Try the finished ecommerce example

The scaffold above is a minimal starting point. Local Goods adds a searchable catalog, persistent cart, demo checkout and local shopping assistant. Open Examples for its source and run instructions; checkout has no payment or fulfillment integration.

Explore Local Goods

If setup fails

If us is not found, check npm prefix -g and ensure its bin directory is on PATH. For runtime problems, run the command below from shop-starter and check the first failed diagnostic. A successful scaffold is separate from a successful app launch.

bash

$ us doctor -p pear-desktop

CLI reference

Published commands and the difference from the source candidate.

Add local AI

Use QVAC after the desktop baseline works.

Troubleshooting

Recognize a setup failure and find the next check.

Packages and integrations

One P2P library, upstream SDKs and optional applications.

Need help? Report an issue with your CLI version, platform, command and first relevant error.