Get started with Codex

Start with Codex installed and signed in, plus Node.js 22.17 or newer and npm. This plugin requires CLI 0.4.0-beta.1. The matching candidate is not on npm yet; use this pinned source build in a new folder. npm 0.3.0 does not supply the maintained workflow. The commands below use a macOS/Linux shell and a user-writable npm prefix.

$ codex --version
codex plugin --help
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

Download the archive above, then run this from your Downloads folder in a macOS or Linux shell. Adjust the folder if your browser saves elsewhere. Keep this terminal open and retain the extracted folder for the local catalog.

$ cd ~/Downloads
tar -xzf unstoppable-stack-plugins-0.1.2.tar.gz
PLUGIN_DIR="$(pwd)/unstoppable-stack-plugin"

Register the extracted local catalog, then install Unstoppable Stack from it. Registration alone does not activate the plugin. Check codex plugin --help if your version uses a different installation surface.

$ codex plugin marketplace add "$PLUGIN_DIR"
codex plugin add unstoppable-stack@unstoppable-stack-dev

This example creates ~/shop-workspace, then launches Codex there after installation. In the Codex desktop app, open that folder and start a new chat instead. Choose a different name if it already exists.

$ cd ~
mkdir shop-workspace
cd shop-workspace
codex

In the new Codex session, select the entry skill by this namespaced name from the available skills. Confirm that it appears before asking it to build.

unstoppable-stack:build-with-unstoppable

Use a small desktop baseline to check the setup. The assistant should inspect the installed CLI and tell you which generated app folder to run.

Scaffold a Pear Desktop app named shop-starter with local storage and peer networking. Use the installed Unstoppable Stack CLI’s actual catalog, keep storage and networking in the worker, install the app dependencies and tell me which folder to run.