Skip to main content
Goose publishes native Linux binaries for both aarch64 and x86_64. Its installer detects the guest architecture, which makes it a relatively small agent setup compared with a large Python environment.

Run Goose

1

Start Goose

On first launch Goose asks whether to share anonymous usage data, then walks through provider configuration. GOOSE_BIN_DIR installs the executable on the sandbox’s normal PATH, including later msb exec sessions. Goose keeps its configuration, data, and session state on the sandbox’s 3 GiB root disk.
For an isolated workspace, or when using microsandbox cloud, replace --mount-dir ./my-project:/workspace:rw with --copy-dir ./my-project:/workspace. To test Goose without a project, use --mkdir /workspace instead.
2

Start another session

After leaving Goose, return to the same sandbox and workspace with:
3

Verify the installation

Exit the session and run:
The pinned installer reports 1.44.0.
4

Review or export changes

With the default writable mount, changes are already in the host checkout. Review them inside the sandbox:
If you chose the isolated --copy-dir alternative, create a patch inside the sandbox:
Copy the patch to the host:
Check that it applies cleanly before applying it:
5

Clean up

Remove the sandbox:
Removing the sandbox also removes its Goose configuration and session data. Changes made through the default workspace mount remain in the host checkout.

Reference