Skip to content
This repository was archived by the owner on May 21, 2026. It is now read-only.
This repository was archived by the owner on May 21, 2026. It is now read-only.

Headless / Vertex orchestrator auth for company environments #4

Description

@SeunghyunLee1982

Motivation: the fork is being trialed in a company environment where interactive OAuth isn't viable (per upstream ToS rules) and headless authentication via Vertex AI or `GEMINI_API_KEY` is required. Currently `gemini-fork` only ships with the OAuth path documented; the harness can only automate setup + analyze, not the orchestrator loop itself.

Goal

Document and validate a headless orchestrator auth path:

  1. `GEMINI_API_KEY` (paid) — set env var, no auth dance. Verify the fork picks it up cleanly and bypasses OAuth.
  2. Vertex AI ADC — `gcloud auth application-default login` once, then service-account / project-bound auth at runtime. Document required env vars (`GOOGLE_CLOUD_PROJECT`, `GOOGLE_CLOUD_LOCATION`, etc.) and how to verify the orchestrator is hitting Vertex.

Updates to ship

  • Working Vertex auth setup section in `FORK-GUIDE.md` (currently the file points at this issue as `#X`).
  • Harness sandbox `.gemini/settings.json` template variants for each auth mode.
  • Test-harness sub-command (e.g. `gemini-fork-harness new --auth=vertex`) that drops the right `settings.json` shape into the sandbox.
  • Headless run mode: `gemini-fork -p` non-interactive variant for scenarios. Once orchestrator auth is headless, the entire scenario run cycle can be automated.

ToS reminder

OAuth (default `oauth-personal`) must NOT be used for headless/automation. Code Assist telemetry hardcodes `isAgentic: true` and the geminicli.com ToS forbids it for third-party tools. The two acceptable paths are `GEMINI_API_KEY` and Vertex AI.

Refs #1.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions