Repository navigation
spaceapp setup 1.1.2
SpaceApp setup 1.1.2 picks a first-run free model that can actually use tools, pins the optional Headroom companion, and makes the setup text and documentation match the launcher.
Fixes
- A first-run model that works with tools. The free OpenCode model for the first session is now checked with a real tool call: it must read a small file with its read tool and answer with the random token inside it. Big Pickle is tried first; when it fails, the newest free tool-capable models are tried. Before, a plain text reply was enough, so a model could be chosen that failed upstream as soon as a task used tools.
- Setup text matches what you get. The setup wizard and Help no longer promise the retired DeepSeek V4 Flash model. The documentation now matches the launcher: the Big Pickle starter model and its first-launch check, profile sizes,
@latestcommands, the 12-character owner password, telemetry, and what stays on your machine when you use a remote model provider.
Supply chain
- The optional Headroom companion image is pinned to a reviewed digest (
headroom-codex-lb:code-5b15319@sha256:491c856a…) instead of the movingcodetag, so installs and updates with companions enabled always run the same image.
Install or update
npx --yes run-spaceapp@latest install
npx --yes run-spaceapp@latest updateValidation
- Exact candidate tested on Linux (VM218), Windows 11 (VM219, signed-in desktop) and macOS Sonoma (VM221): fresh install with automatic browser opening, owner setup, a first native AI task on a free OpenCode model, update from 1.1.1, repair, stopped Docker, stopped-PostgreSQL upgrade, small/medium/large profile changes,
doctor --fix, and a real guest restart with the same containers. - After publication,
run-spaceapp@nextwas installed fresh and used to upgrade a retained 1.1.1 installation (first installed from the registry at 1.0.35) on all three systems; the containers ran the exact published GHCR digests and the database, files, secrets and workspaces were preserved. - After promotion to
latest,npx --yes run-spaceapp@latest update(no explicit version, no local images) upgraded another retained 1.1.1 installation on all three systems to the exact published digests, with database, files, secrets and workspaces preserved. - Release workflow: https://github.com/oll4com/spaceapp/actions/runs/38210739244
Known limitations
- Free models can change upstream at any time. If the selected free model stops responding, switch models in OpenCode; the next fresh install checks the models again.
- macOS: in the restart test, a file written a few seconds before the Mac restarted was lost unless the data was flushed inside the core container first (Docker Desktop writes its VM disk on its own schedule). Data written earlier was preserved.