goose/README.md

Goose is your on-machine developer agent, working for you, on your terms

GOOSE 1.0!!

This is the branch for goose 1.0 WIP: which is a port over from python to rust + typescript/electron for optional desktop environment. WATCH THIS SPACE

Building

cargo build

Running the CLI

Configure

goose configure

Add/Remove system

goose system add <system_url>
goose system remove <system_url>

OpenAI provider (default):

export OPENAI_API_KEY=...

cargo run --bin goose -- session

Databricks provider (TODO):

export DATABRICKS_HOST=...
export DATABRICKS_TOKEN=...

cargo run --bin goose -- session

Headless mode

Run goose once-off with instructions from a file

Usage: cargo run --bin goose -- run -i instructions.md

GUI

Goose has an electron based GUI which you can see in ui/desktop:

Start sub system server

cd crates/stub-system
cargo run

Troubleshooting

Compiling tokenizers library

tokenizers depends on esaxx-rs which failed to compile because 'cstdint' file was not found. The following fixed it:

export CXXFLAGS="-isystem $(xcrun --show-sdk-path)/usr/include/c++/v1"
cargo check