VIEWPORT
For developers

Gemini

Run the Gemini CLI under Viewport's session and approval surface.

PlannedDescribed to intent. Not yet implemented in code.

What works today

vpd install detects the Gemini CLI binary in BUILT_IN_AGENTS and reports its presence. The hook bridge is not yet wired.

What's coming

  • Session lifecycle detection (start / end / tool-call) via Gemini's plugin mechanism.
  • Plan-then-execute mode integration.
  • Per-tool permission gate translation to inbox approval items.
  • Cost tracking via Gemini's usage events.

Workaround in the meantime

You can wrap Gemini in a vpd run shell:

vpd run ~/code/api --command "gemini --prompt 'fix the failing tests'"

This treats the run as a single session: start → end with no fine-grained frames in between. Plan review and approval gates won't fire; you'll see the run as a single block in /sessions.

Where to go next

On this page