Will Pfleger
0164300649
* main: (54 commits) add clippy warning for string_slice (#5422) improve linux tray icon support (#5425) feat: log rotation (#5561) use app.isPackaged instead of checking for node env development (#5465) disable RPM build-ID generation to prevent package conflicts (#5563) Add Diagnostics Info to Q&A and Bug Report Templates (#5565) fix: improve server error messages to include HTTP status code (#5532) improvement: add useful error message when attempting to use unauthenticated cursor-agent (#5300) fix: unblock acp via databricks (#5562) feat: add --output-format json flag to goose run command (#5525) Sessions required (#5548) feat: add grouped extension loading notification (#5529) we should run this on main and also test open models at least via ope… (#5556) info: print location of sessions.db via goose info (#5557) chore: remove yarn usage from documentation (#5555) cli: adjust default theme to address #1905 (#5552) Manual compaction counting fix + cli cleanup (#5480) chore(deps): bump prismjs and react-syntax-highlighter in /ui/desktop (#5549) fix: remove qwen3-coder from provider/mcp smoke tests (#5551) fix: do not build unsigned desktop app bundles on every PR in ci. add manual option. (#5550) ...
goose Desktop App
Native desktop app for goose built with Electron and ReactJS.
Building and running
goose uses Hermit to manage dependencies, so you will need to have it installed and activated.
git clone git@github.com:block/goose.git
cd goose
source ./bin/activate-hermit
cd ui/desktop
npm install
npm run start
Platform-specific build requirements
Linux
For building on Linux distributions, you'll need additional system dependencies:
Debian/Ubuntu:
sudo apt install dpkg fakeroot
Arch/Manjaro:
sudo pacman -S dpkg fakeroot
Fedora/RHEL:
sudo dnf install dpkg-dev fakeroot
Building notes
This is an electron forge app, using vite and react.js. goosed runs as multi process binaries on each window/tab similar to chrome.
Building for different platforms
macOS
npm run bundle:default will give you a goose.app/zip which is signed/notarized but only if you setup the env vars as per forge.config.ts (you can empty out the section on osxSign if you don't want to sign it) - this will have all defaults.
npm run bundle:preconfigured will make a goose.app/zip signed and notarized, but use the following:
f" process.env.GOOSE_PROVIDER__TYPE = '{os.getenv("GOOSE_BUNDLE_TYPE")}';",
f" process.env.GOOSE_PROVIDER__HOST = '{os.getenv("GOOSE_BUNDLE_HOST")}';",
f" process.env.GOOSE_PROVIDER__MODEL = '{os.getenv("GOOSE_BUNDLE_MODEL")}';"
This allows you to set for example GOOSE_PROVIDER__TYPE to be "databricks" by default if you want (so when people start goose.app - they will get that out of the box). There is no way to set an api key in that bundling as that would be a terrible idea, so only use providers that can do oauth (like databricks can), otherwise stick to default goose.
Linux
For Linux builds, first ensure you have the required system dependencies installed (see above), then:
- Build the Rust backend:
cd ../.. # Go to project root
cargo build --release -p goose-server
- Copy the server binary to the expected location:
mkdir -p src/bin
cp ../../target/release/goosed src/bin/
- Build the application:
# For ZIP distribution (works on all Linux distributions)
npm run make -- --targets=@electron-forge/maker-zip
# For DEB package (Debian/Ubuntu)
npm run make -- --targets=@electron-forge/maker-deb
The built application will be available in:
- ZIP:
out/make/zip/linux/x64/goose-linux-x64-{version}.zip - DEB:
out/make/deb/x64/goose_{version}_amd64.deb - Executable:
out/goose-linux-x64/goose
Windows
Use the existing Windows build process as documented.
Running with goosed server from source
Set VITE_START_EMBEDDED_SERVER=yes to no in .env.
Run cargo run -p goose-server from parent dir.
npm run start will then run against this.
You can try server directly with ./test.sh