RepoPilot

aaif-goose / goose

Search aaif-goose/goose

GitHub

Get started

Taken from the repository's own files on 24 Oct 2026. RepoPilot has not run these commands.

Prerequisites

The files RepoPilot read do not name a runtime version or package manager.

Commands

No scripts found at the top level of the repository. Check Cargo.toml .

No installation or usage section was found in the README. Read the README

Developing

CONTRIBUTING.md

Rust

First let's compile goose and try it out Since goose requires Hermit for managing dependencies, let's activate hermit.

cd goose
source ./bin/activate-hermit
cargo build

When that completes, debug builds of the binaries are available, including the goose CLI:

./target/debug/goose --help

For first-time setup, run the configure command:

./target/debug/goose configure

Once a connection to an LLM provider is working, start a session:

./target/debug/goose session

These same commands can be recompiled and immediately run using cargo run -p goose-cli for iteration. When making changes to the Rust code, test them on the CLI or run checks, tests, and the linter:

cargo check  # verify changes compile
cargo test  # run tests with changes
cargo fmt   # format code
cargo clippy --all-targets -- -D warnings # run the linter

Node

To run the app:

just run-ui

This command builds a release build of Rust (equivalent to cargo build -r) and starts the Electron process. The app opens a window and displays first-time setup. After completing setup, goose is ready for use.

Make GUI changes in ui/desktop.

Troubleshooting: blank screen on just run-ui

If the app opens to a blank window (logs show Cannot read properties of null (reading 'useRef')), your node_modules is out of date and is loading two copies of React. Delete it and reinstall:

rm -rf ui/desktop/node_modules
cd ui && pnpm install

See #8757.

Read the rest of CONTRIBUTING.md