Skip to content

fix(plugins): package Gemini releases and improve OAuth - #94

Merged
lxcong merged 3 commits into
chainbase-labs:mainfrom
zzAllenn:codex/fix-gemini-release-assets
Aug 11, 2026
Merged

fix(plugins): package Gemini releases and improve OAuth#94
lxcong merged 3 commits into
chainbase-labs:mainfrom
zzAllenn:codex/fix-gemini-release-assets

Conversation

@zzAllenn

@zzAllenn zzAllenn commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Summary

  • preserve the existing agentkey.skill GitHub Release asset and add platform-named Gemini extension archives for macOS, Linux, and Windows
  • opt the Gemini extension into native first-connect OAuth with oauth.enabled, while keeping /mcp auth agentkey as the manual retry path
  • add explicit Gemini, Antigravity 2.0, and Antigravity CLI authentication and connection-verification guidance
  • explain Gemini's user-Skill precedence warning and avoid duplicate MCP registrations when an extension or plugin already owns the server entry
  • add regression coverage and trigger the scripts test workflow when authentication guidance or release packaging changes

Root causes

Gemini CLI treats a lone generic GitHub Release asset as the extension archive. AgentKey releases currently publish only agentkey.skill, but Gemini CLI extracts only .tar.gz and .zip extension archives. After that extraction failure, Gemini retries Git clone in the same non-empty temporary directory and fails again.

Separately, the Gemini manifest omitted oauth.enabled. Gemini discovered that AgentKey required OAuth, but only reported /mcp auth agentkey instead of starting the browser flow automatically. A pre-existing user Skill at ~/.agents/skills/agentkey can also override the extension-bundled Skill, hiding new setup guidance even though the extension MCP entry is active.

Authentication design

  • Gemini uses httpUrl plus oauth.enabled: true; OAuth endpoints and client registration remain dynamically discovered.
  • Antigravity keeps the documented credential-free serverUrl configuration and uses DCR through its native Authenticate controls.
  • No static access token, Authorization header, OAuth client secret, or hard-coded authorization endpoint is added to either package.

Validation

  • Bats suite: 27/27 passing
  • gemini extensions validate .
  • built and inspected agentkey.skill, darwin.agentkey.tar.gz, linux.agentkey.tar.gz, and win32.agentkey.zip
  • verified both Gemini platform archive formats contain oauth.enabled: true, gemini-extension.json, and skills/agentkey/SKILL.md
  • validated workflow YAML, shell syntax, archive roots, manifest invariants, and git diff --check
  • verified the live AgentKey endpoint advertises protected-resource metadata, PKCE, and a dynamic client registration endpoint

Release coordination

Merge this fix before release PR #92 so the first Gemini-enabled release publishes compatible archives and the corrected first-connect OAuth behavior.

@zzAllenn
zzAllenn marked this pull request as ready for review August 11, 2026 07:26
@zzAllenn zzAllenn changed the title fix(ci): package Gemini extension release assets fix(plugins): package Gemini releases and improve OAuth Aug 11, 2026
@lxcong
lxcong merged commit fbec683 into chainbase-labs:main Aug 11, 2026
5 checks passed
lxcong added a commit that referenced this pull request Aug 22, 2026
🤖 I have created a release *beep* *boop*
---


##
[1.14.0](v1.13.1...v1.14.0)
(2026-08-22)


### Features

* add Cursor, Gemini CLI, and Antigravity plugin support
([#91](#91))
([49a015b](49a015b))
* add DeepSeek Harness and Kimi MCP routing
([#96](#96))
([97e3ab2](97e3ab2))


### Bug Fixes

* **claude:** restore native MCP OAuth login
([#95](#95))
([efc2809](efc2809))
* **plugins:** package Gemini releases and improve OAuth
([#94](#94))
([fbec683](fbec683))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants