Early stage and part of goose's broader move to ACP
aaif-goose#6642 aaif-goose#7309
The TUI launches the goose ACP server by spawning goose acp. Which binary it spawns is resolved by @aaif/goose-sdk:
- the
GOOSE_BINARYenvironment variable, if set, otherwise - the platform's prebuilt
@aaif/goose-binary-*package (an optional dependency of the pinned@aaif/goose-sdk).
cd ui/text
pnpm install # pulls the pinned @aaif/goose-sdk and its matching @aaif/goose-binary-* package
pnpm start # tsx src/tui.tsx — runs against the released binary, no Rust buildThe TUI pins a specific @aaif/goose-sdk version, so pnpm start always runs against a goose binary that matches the SDK.
To test local Rust changes, run the dev launcher directly. It builds a debug binary (cargo build -p goose-cli → target/debug/goose) from the workspace root and points the TUI at it via GOOSE_BINARY:
node scripts/dev-start.mjsIf your changes touch the ACP schema, also point the TUI at the in-repo SDK so the two stay matched: set @aaif/goose-sdk to workspace:* in package.json and re-run pnpm install. Otherwise the locally built binary may not match the pinned published SDK's schema. Revert that change before committing — the TUI is meant to stay frozen on its pinned SDK version.
To run any other prebuilt binary, set GOOSE_BINARY=/path/to/goose and use pnpm start.
To connect to an already-running server instead of spawning a binary:
pnpm start -- --server http://localhost:8080