Skip to content

Skip binary CLI relaunch#26261

Merged
ruomengz merged 3 commits intomainfrom
sea-binary
Apr 30, 2026
Merged

Skip binary CLI relaunch#26261
ruomengz merged 3 commits intomainfrom
sea-binary

Conversation

@ruomengz
Copy link
Copy Markdown
Contributor

Summary

This PR introduces support for running the Gemini CLI as a single-file executable (SEA) by skipping the daemon relaunch process when the IS_BINARY environment variable is set. It also adds a new GitHub Actions workflow to build unsigned Mac binaries on demand.

Details

  • SEA Support: Added a check for process.env['IS_BINARY'] in the CLI entry point and React component to skip the lightweight parent process relaunch. This is necessary because SEA environments often have different node argument requirements and the relaunch mechanism can conflict with the bundled nature of the binary.
  • New Workflow: Added .github/workflows/build-unsigned-mac-binaries.yml to allow manual triggering of Mac binary builds (x64 and arm64) without requiring code signing. This is useful for rapid testing and distribution to internal/trusted testers.
  • Build Script Update: Modified scripts/build_binary.js to respect a SKIP_SIGNING environment variable, allowing the build process to complete even when signing certificates are not available.

Related Issues

Fixes https://github.com/google-gemini/maintainers-gemini-cli/issues/1638

How to Validate

  1. Local SEA Build:

    SKIP_SIGNING=true npm run build:binary
    IS_BINARY=true ./dist/darwin-arm64/gemini --version

    Verify the binary runs without relaunching.

  2. GitHub Action:
    Manually trigger the "Build Unsigned Mac Binaries" workflow on this branch and verify that the artifacts are generated and downloadable.

Pre-Merge Checklist

  • Updated relevant documentation and README (if needed)
  • Added/updated tests (if needed) - Note: Pre-existing test failures in core package were verified as environmental.
  • Noted breaking changes (if any)
  • Validated on required platforms/methods:
    • MacOS
      • npm run
      • npx
      • Binary (SEA)

@ruomengz ruomengz requested review from a team as code owners April 30, 2026 14:48
@gemini-cli
Copy link
Copy Markdown
Contributor

gemini-cli Bot commented Apr 30, 2026

Hi @ruomengz, thank you so much for your contribution to Gemini CLI! We really appreciate the time and effort you've put into this.

We're making some updates to our contribution process to improve how we track and review changes. Please take a moment to review our recent discussion post: Improving Our Contribution Process & Introducing New Guidelines.

Key Update: Starting January 26, 2026, the Gemini CLI project will require all pull requests to be associated with an existing issue. Any pull requests not linked to an issue by that date will be automatically closed.

Thank you for your understanding and for being a part of our community!

@gemini-code-assist
Copy link
Copy Markdown
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request enables the Gemini CLI to function correctly as a single-file executable by preventing unnecessary process relaunching. Additionally, it streamlines the development and testing workflow by providing mechanisms to build unsigned binaries on demand.

Highlights

  • SEA Support: Introduced the IS_BINARY environment variable to bypass the daemon relaunch process, ensuring compatibility with single-file executable environments.
  • Build Workflow: Added a new GitHub Actions workflow to facilitate the manual generation of unsigned Mac binaries for testing purposes.
  • Build Script Flexibility: Updated the binary build script to respect the SKIP_SIGNING environment variable, allowing builds to proceed without code signing certificates.
Ignored Files
  • Ignored by pattern: .github/workflows/** (1)
    • .github/workflows/build-unsigned-mac-binaries.yml
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces support for binary builds by incorporating checks for the IS_BINARY environment variable to control process relaunching and memory argument configuration. Additionally, it adds a mechanism to skip file signing during the build process via the SKIP_SIGNING environment variable. The review feedback suggests refining the IS_BINARY checks to explicitly compare against the string 'true' for consistency and to prevent logical errors when the variable is set to 'false'.

Comment thread packages/cli/index.ts
Comment thread packages/cli/src/gemini.tsx
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 30, 2026

Size Change: +100 B (0%)

Total Size: 33.9 MB

Filename Size Change
./bundle/chunk-7FXC36TH.js 0 B -3.43 kB (removed) 🏆
./bundle/chunk-BWV3CGS2.js 0 B -19.5 kB (removed) 🏆
./bundle/chunk-HQ2BNR2A.js 0 B -12.6 kB (removed) 🏆
./bundle/chunk-L5S7SMIL.js 0 B -2.72 MB (removed) 🏆
./bundle/chunk-NQJDCJAK.js 0 B -3.8 kB (removed) 🏆
./bundle/chunk-P7UOP2CB.js 0 B -14.7 MB (removed) 🏆
./bundle/chunk-QW2RJHD7.js 0 B -49.2 kB (removed) 🏆
./bundle/chunk-WCDXTSYE.js 0 B -655 kB (removed) 🏆
./bundle/core-F76P3CYN.js 0 B -48.2 kB (removed) 🏆
./bundle/devtoolsService-325LDILM.js 0 B -28 kB (removed) 🏆
./bundle/gemini-VVWQP7J3.js 0 B -580 kB (removed) 🏆
./bundle/interactiveCli-XP3M34EH.js 0 B -1.31 MB (removed) 🏆
./bundle/liteRtServerManager-NWL62OOM.js 0 B -2.11 kB (removed) 🏆
./bundle/oauth2-provider-N6WBYKWL.js 0 B -9.16 kB (removed) 🏆
./bundle/chunk-3E5EQYC4.js 14.7 MB +14.7 MB (new file) 🆕
./bundle/chunk-4DPMSURX.js 49.2 kB +49.2 kB (new file) 🆕
./bundle/chunk-G2H4YH6V.js 3.43 kB +3.43 kB (new file) 🆕
./bundle/chunk-HJMRTPBP.js 655 kB +655 kB (new file) 🆕
./bundle/chunk-JACIYHG7.js 19.5 kB +19.5 kB (new file) 🆕
./bundle/chunk-KYCJMILL.js 2.72 MB +2.72 MB (new file) 🆕
./bundle/chunk-OHGY6AYA.js 12.6 kB +12.6 kB (new file) 🆕
./bundle/chunk-QWFOFDEZ.js 3.8 kB +3.8 kB (new file) 🆕
./bundle/core-QEBZLKCM.js 48.2 kB +48.2 kB (new file) 🆕
./bundle/devtoolsService-FLOESLVJ.js 28 kB +28 kB (new file) 🆕
./bundle/gemini-CYAYKYUW.js 580 kB +580 kB (new file) 🆕
./bundle/interactiveCli-EYQ4PXTR.js 1.31 MB +1.31 MB (new file) 🆕
./bundle/liteRtServerManager-LCMOAYUN.js 2.11 kB +2.11 kB (new file) 🆕
./bundle/oauth2-provider-RFUJDPV6.js 9.16 kB +9.16 kB (new file) 🆕
ℹ️ View Unchanged
Filename Size Change
./bundle/bundled/third_party/index.js 8 MB 0 B
./bundle/chunk-34MYV7JD.js 2.45 kB 0 B
./bundle/chunk-5AUYMPVF.js 858 B 0 B
./bundle/chunk-5PS3AYFU.js 1.18 kB 0 B
./bundle/chunk-664ZODQF.js 124 kB 0 B
./bundle/chunk-DAHVX5MI.js 206 kB 0 B
./bundle/chunk-IUUIT4SU.js 56.5 kB 0 B
./bundle/chunk-RJTRUG2J.js 39.8 kB 0 B
./bundle/chunk-XRLFHCHC.js 1.97 MB 0 B
./bundle/cleanup-FAXUYKKI.js 0 B -932 B (removed) 🏆
./bundle/devtools-36NN55EP.js 696 kB 0 B
./bundle/dist-T73EYRDX.js 356 B 0 B
./bundle/events-XB7DADIJ.js 418 B 0 B
./bundle/examples/hooks/scripts/on-start.js 188 B 0 B
./bundle/examples/mcp-server/example.js 1.43 kB 0 B
./bundle/gemini.js 5.14 kB +39 B (+0.76%)
./bundle/getMachineId-bsd-TXG52NKR.js 1.55 kB 0 B
./bundle/getMachineId-darwin-7OE4DDZ6.js 1.55 kB 0 B
./bundle/getMachineId-linux-SHIFKOOX.js 1.34 kB 0 B
./bundle/getMachineId-unsupported-5U5DOEYY.js 1.06 kB 0 B
./bundle/getMachineId-win-6KLLGOI4.js 1.72 kB 0 B
./bundle/memoryDiscovery-FN3IAPBT.js 980 B 0 B
./bundle/multipart-parser-KPBZEGQU.js 11.7 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/client/main.js 222 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/_client-assets.js 229 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/index.js 13.4 kB 0 B
./bundle/node_modules/@google/gemini-cli-devtools/dist/src/types.js 132 B 0 B
./bundle/sandbox-macos-permissive-open.sb 890 B 0 B
./bundle/sandbox-macos-permissive-proxied.sb 1.31 kB 0 B
./bundle/sandbox-macos-restrictive-open.sb 3.36 kB 0 B
./bundle/sandbox-macos-restrictive-proxied.sb 3.56 kB 0 B
./bundle/sandbox-macos-strict-open.sb 4.82 kB 0 B
./bundle/sandbox-macos-strict-proxied.sb 5.02 kB 0 B
./bundle/src-QVCVGIUX.js 47 kB 0 B
./bundle/start-PCSSMGDB.js 0 B -652 B (removed) 🏆
./bundle/tree-sitter-7U6MW5PS.js 274 kB 0 B
./bundle/tree-sitter-bash-34ZGLXVX.js 1.84 MB 0 B
./bundle/cleanup-KJVSG5RZ.js 932 B +932 B (new file) 🆕
./bundle/start-K6MKGGLM.js 652 B +652 B (new file) 🆕

compressed-size-action

@ruomengz
Copy link
Copy Markdown
Contributor Author

Addresses feedback regarding IS_BINARY checks. I've updated both packages/cli/index.ts and packages/cli/src/gemini.tsx to use explicit === 'true' (or !== 'true') string comparisons to ensure consistency and prevent logical errors if the variable is set to the string "false".

@gemini-cli gemini-cli Bot added the status/need-issue Pull requests that need to have an associated issue. label Apr 30, 2026
- Add GitHub Actions workflow to build unsigned Mac binaries on demand
- Add `SKIP_SIGNING` flag to `build_binary.js` to bypass code signing
- Skip daemon relaunch in CLI when `IS_BINARY` is set
Copy link
Copy Markdown
Contributor

@sripasg sripasg left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thanks Ruomeng !

@ruomengz ruomengz added this pull request to the merge queue Apr 30, 2026
Merged via the queue into main with commit 0f10770 Apr 30, 2026
26 checks passed
@ruomengz ruomengz deleted the sea-binary branch April 30, 2026 18:01
TirthNaik-99 pushed a commit to TirthNaik-99/gemini-cli that referenced this pull request May 4, 2026
kimjune01 pushed a commit to kimjune01/gemini-cli-claude that referenced this pull request May 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

status/need-issue Pull requests that need to have an associated issue.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants