hermes-antigravity-oauth: model tool for Hermes Agent

Run Hermes Agent on a Google Antigravity plan through the official agy CLI, with SOUL.md as the persona

What hermes-antigravity-oauth does

The plugin sends no HTTP requests of its own. Each model call is made by Google's agy binary under agy's own login, and sign-in is agy's browser OAuth flow, confirmed live with agy models. The token stays wherever agy stores it, and the plugin does not read, copy, upload or write it. The README names Gemini 3.x, Claude 4.6 and GPT-OSS as models reachable on the plan.

Your Hermes SOUL.md becomes the persona. Each turn the plugin writes the Hermes system prompt into agy's private workspace as GEMINI.md, starting with SOUL.md. agy's built-in tools never run on your host: when a model calls one, the plugin re-issues it as the matching Hermes tool, for example run_command to terminal or view_file to read_file, so it runs under Hermes approvals and sandbox. Any other native tool is blocked. The plugin adds hermes auth commands for adding, checking and logging out of the provider.

Key features

Every model request is made by the official agy CLI under agy's own login
SOUL.md is written into agy's workspace as GEMINI.md each turn
agy tool calls are re-issued as Hermes tools and run under Hermes approvals and sandbox
hermes auth add, status and logout commands for antigravity-oauth
npx installer with install, login, status and uninstall commands
Environment variables ANTIGRAVITY_COMMAND and ANTIGRAVITY_WORKSPACE_RULES for tuning

When to use it

Running Hermes Agent on an existing Google Antigravity plan instead of a separate API key
Keeping a SOUL.md persona while switching the model provider to Antigravity
Signing in to the provider over SSH by pasting the code back when asked

Who it is for: Hermes Agent users who already have a Google Antigravity plan and want Hermes to run on it.

How it fits with Hermes Agent

A Hermes plugin that registers the antigravity-oauth model provider, with aliases google-antigravity and agy-oauth, selected with the hermes --provider flag.

How to install hermes-antigravity-oauth

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

npx hermes-antigravity-oauth
hermes plugins install https://github.com/neerazz/hermes-antigravity-oauth --enable
hermes auth add antigravity-oauth

Requirements: Hermes Agent plus the Antigravity CLI (agy)

Note: It needs a Google Antigravity plan and Google's agy CLI, and GitHub does not recognize a standard license for the repository.

FAQ

What is hermes-antigravity-oauth?

hermes-antigravity-oauth is a Hermes Agent plugin that lets Hermes run on a Google Antigravity plan. It routes every model request through Google's official agy CLI and uses your SOUL.md as the persona.

Does hermes-antigravity-oauth work with Hermes Agent?

Yes. It is built as a Hermes plugin and adds a provider you select with hermes --provider antigravity-oauth. Tool calls from agy are re-issued as Hermes tools so they run under Hermes approvals.

How do I install hermes-antigravity-oauth?

Run npx hermes-antigravity-oauth, which installs and enables the plugin and then signs you in. You can also run hermes plugins install with the repository URL and the --enable flag, then hermes auth add antigravity-oauth.