feat: add flatpak support for linux #6387

The-Best-Codes · 2026-01-07T23:26:49Z

Summary

Adding a .flatpak to the Linux bundle. This allows Linux users to install goose easily via Flatpak, and goose can later be added to the Flathub registry.
See related discussion in Discord:
https://discord.com/channels/1287729918100246654/1458170369163661608

Type of Change

Feature

AI Assistance

This PR was created or reviewed with AI assistance

Testing

Manually testing and working on Arch Linux.

Signed-off-by: The-Best-Codes <[email protected]>

The-Best-Codes · 2026-01-08T00:53:57Z

If anyone is manually testing this on Linux, you can run this:

npm run make -- --platform=linux --targets=@electron-forge/maker-flatpak

To skip the rpm and deb builds and just test with flatpak.

Signed-off-by: The-Best-Codes <[email protected]>

The-Best-Codes

Ready for review

Signed-off-by: The-Best-Codes <[email protected]>

Copilot

Pull request overview

This PR adds Flatpak support to the Linux desktop app distribution, enabling Linux users to install goose via Flatpak and prepare for potential Flathub registry inclusion. The implementation adds the necessary Electron Forge maker, configures the Flatpak build with runtime version 25.08, and updates the CI workflow to build and upload Flatpak packages.

Key Changes:

Adds @electron-forge/maker-flatpak dependency to package.json
Configures Flatpak builder in forge.config.ts with permissions, runtime settings, and a custom libbz2 shim
Updates Linux CI workflow to install Flatpak tools and build .flatpak packages

Reviewed changes

Copilot reviewed 3 out of 4 changed files in this pull request and generated 5 comments.

File	Description
ui/desktop/package.json	Adds @electron-forge/maker-flatpak@^7.10.2 as a dev dependency
ui/desktop/package-lock.json	Adds flatpak maker and related dependencies (@malept/electron-installer-flatpak, @malept/flatpak-bundler) with transitive dependencies
ui/desktop/forge.config.ts	Configures Flatpak maker with runtime 25.08, permissions (finishArgs), and custom libbz2-shim module
.github/workflows/bundle-desktop-linux.yml	Installs flatpak, flatpak-builder, and elfutils; adds Flathub remote; builds .flatpak package; uploads as separate artifact

Files not reviewed (1)

ui/desktop/package-lock.json: Language not supported

.github/workflows/bundle-desktop-linux.yml

ui/desktop/forge.config.ts

michaelneale · 2026-01-10T04:40:18Z

some strong suggestions from copilot here - are they relevant? (perhaps it does know about the actions - given it is made by github) but it is hard to know.

michaelneale · 2026-01-10T05:18:31Z

@The-Best-Codes if you needed to test on a real action, could change or add a temporary workflow which targets this branch and runs it there (then can remove it when we know it works - I have done that before) as github actions are really a pain TBH to test

The-Best-Codes · 2026-01-10T19:06:22Z

@michaelneale As best I can tell, at least 4 of the 5 from Copilot are irrelevant 😅

if you needed to test on a real action, could change or add a temporary workflow which targets this branch and runs it there (then can remove it when we know it works - I have done that before) as github actions are really a pain TBH to test

Sounds like a plan. I will do that 👍

Signed-off-by: The-Best-Codes <[email protected]>

The-Best-Codes · 2026-01-10T20:24:12Z

Also, for testing actions locally, if you've got a powerful enough machine, I highly recommend act :)

Signed-off-by: The-Best-Codes <[email protected]>

The-Best-Codes · 2026-01-12T17:22:24Z

@alexhancock Not ready to merge FYI. Thanks for reviewing! ❤️

Signed-off-by: The-Best-Codes <[email protected]>

The-Best-Codes

If the tests pass, this is ready to merge now 😀

The-Best-Codes · 2026-01-12T20:00:08Z

Ewww merge conflicts. Let me fix those.

Signed-off-by: The-Best-Codes <[email protected]>

github-actions · 2026-01-12T20:10:15Z

PR Preview Action v1.6.3
Preview removed because the pull request was closed.
2026-01-14 18:26 UTC

taniandjerry · 2026-01-14T16:44:34Z

Merge conflicts have been resolved by @The-Best-Codes , just needs final re-review!

alexhancock · 2026-01-14T16:48:06Z

@taniandjerry If you stamp it as well we will have the requisite devrel approval (given the docs updates) and can merge.

* main: fixed 0 token in openrouter steaming (#6493) feat(goose-acp): enable parallel sessions with isolated agent state (#6392) copilot instruction to flag prelease docs (#6504) docs: acp mcp support (#6491) feat: add flatpak support for linux (#6387) fix(code_execution): serialize record_result output as JSON (#6495) perf(google): avoid accumulating thoughtSignatures across conversation history (#6462) fix(openai): make tool_call arguments optional and fix silent stream termination (#6309) fix: Improve error messages for invalid tool calls (#6483)

…ased * 'main' of github.com:block/goose: Fix popular topics not starting chat when clicked (#6508) fix[desktop]: deeplink ui repeat on refresh (#6469) fixed test compilation on main branch (#6512) fix: correctly parse extension name from tool call for MCP apps (#6482) fixed 0 token in openrouter steaming (#6493) feat(goose-acp): enable parallel sessions with isolated agent state (#6392) copilot instruction to flag prelease docs (#6504) docs: acp mcp support (#6491) feat: add flatpak support for linux (#6387)

* 'main' of github.com:block/goose: (28 commits) chore(deps): bump aiohttp from 3.13.0 to 3.13.3 in /scripts/provider-error-proxy (#6539) chore(deps): bump brotli from 1.1.0 to 1.2.0 in /scripts/provider-error-proxy (#6538) docs: temp correction for agent directory (#6544) chore: upgrade rmcp (#6516) docs: clarify directory in /documentation readme (#6541) Release 1.20.0 Standalone mcp apps (#6458) don't add escaping to the command field (#6519) Fix popular topics not starting chat when clicked (#6508) fix[desktop]: deeplink ui repeat on refresh (#6469) fixed test compilation on main branch (#6512) fix: correctly parse extension name from tool call for MCP apps (#6482) fixed 0 token in openrouter steaming (#6493) feat(goose-acp): enable parallel sessions with isolated agent state (#6392) copilot instruction to flag prelease docs (#6504) docs: acp mcp support (#6491) feat: add flatpak support for linux (#6387) fix(code_execution): serialize record_result output as JSON (#6495) perf(google): avoid accumulating thoughtSignatures across conversation history (#6462) fix(openai): make tool_call arguments optional and fix silent stream termination (#6309) ...

fix: add flatpak support for linux

30d56bf

Signed-off-by: The-Best-Codes <[email protected]>

The-Best-Codes self-assigned this Jan 7, 2026

The-Best-Codes changed the title ~~fix: add flatpak support for linux~~ feat: add flatpak support for linux Jan 8, 2026

The-Best-Codes added 2 commits January 9, 2026 13:20

fixed some issues

7800cc3

Signed-off-by: The-Best-Codes <[email protected]>

fix .flatpak libbz2 issues

265a8bf

Signed-off-by: The-Best-Codes <[email protected]>

The-Best-Codes marked this pull request as ready for review January 9, 2026 23:09

The-Best-Codes commented Jan 9, 2026

View reviewed changes

fix: update workflow msg

6b33b90

Signed-off-by: The-Best-Codes <[email protected]>

angiejones requested a review from Copilot January 9, 2026 23:57

Copilot started reviewing on behalf of angiejones January 9, 2026 23:58 View session

Copilot AI reviewed Jan 10, 2026

View reviewed changes

The-Best-Codes added 3 commits January 10, 2026 13:27

flatpak test repo

c59ab8c

Signed-off-by: The-Best-Codes <[email protected]>

Update test-flatpak.yml

0c77680

Signed-off-by: The-Best-Codes <[email protected]>

debug

b90dd39

Signed-off-by: The-Best-Codes <[email protected]>

The-Best-Codes added 2 commits January 10, 2026 14:26

more workflow testing

cb9dd70

Signed-off-by: The-Best-Codes <[email protected]>

more debugging 😭

0637f64

Signed-off-by: The-Best-Codes <[email protected]>

alexhancock approved these changes Jan 12, 2026

View reviewed changes

The-Best-Codes added 3 commits January 12, 2026 13:23

change test runner

c63b644

Signed-off-by: The-Best-Codes <[email protected]>

done testing, add flatpak to bundle-desktop-linux.yml

7e18d76

Signed-off-by: The-Best-Codes <[email protected]>

update docs with flatpak link

6e3ffde

Signed-off-by: The-Best-Codes <[email protected]>

The-Best-Codes requested a review from a team as a code owner January 12, 2026 19:52

The-Best-Codes added 3 commits January 12, 2026 13:52

update desktop readme

d18cc72

Signed-off-by: The-Best-Codes <[email protected]>

add instructions for building flatpak in BUILDING_LINUX.md

3a00f86

Signed-off-by: The-Best-Codes <[email protected]>

update release workflows to include *.flatpak artifacts

3435b89

Signed-off-by: The-Best-Codes <[email protected]>

The-Best-Codes commented Jan 12, 2026

View reviewed changes

Merge remote-tracking branch 'upstream/main' into best/flatpak

3fa224c

Signed-off-by: The-Best-Codes <[email protected]>

The-Best-Codes force-pushed the best/flatpak branch from c02de4b to 3fa224c Compare January 12, 2026 20:05

The-Best-Codes requested a review from alexhancock January 13, 2026 05:45

alexhancock approved these changes Jan 14, 2026

View reviewed changes

dianed-square approved these changes Jan 14, 2026

View reviewed changes

alexhancock merged commit 20b8cbd into main Jan 14, 2026
28 of 30 checks passed

alexhancock deleted the best/flatpak branch January 14, 2026 18:21

feat: add flatpak support for linux #6387

feat: add flatpak support for linux #6387

Uh oh!

Conversation

The-Best-Codes commented Jan 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Type of Change

AI Assistance

Testing

Uh oh!

The-Best-Codes commented Jan 8, 2026

Uh oh!

The-Best-Codes left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

michaelneale commented Jan 10, 2026

Uh oh!

michaelneale commented Jan 10, 2026

Uh oh!

The-Best-Codes commented Jan 10, 2026

Uh oh!

The-Best-Codes commented Jan 10, 2026

Uh oh!

The-Best-Codes commented Jan 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

The-Best-Codes left a comment

Choose a reason for hiding this comment

Uh oh!

The-Best-Codes commented Jan 12, 2026

Uh oh!

github-actions bot commented Jan 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

taniandjerry commented Jan 14, 2026

Uh oh!

alexhancock commented Jan 14, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

The-Best-Codes commented Jan 7, 2026 •

edited

Loading

The-Best-Codes commented Jan 12, 2026 •

edited

Loading

github-actions bot commented Jan 12, 2026 •

edited

Loading