feat: Gemini CLI runtime adapter support

[Q00]

Summary

Add Google Gemini CLI as a supported runtime adapter for Ouroboros, allowing users to leverage Gemini models natively through their CLI tool.

Motivation

Expanding runtime support beyond Claude Code and OpenCode to include Gemini CLI would broaden Ouroboros's reach. Community contributors are welcome to pick this up.

Scope

• Research Gemini CLI output format and streaming behavior
• Implement GeminiCLIAdapter provider
• Implement GeminiCLIRuntime orchestrator
• Event normalizer for Gemini CLI output
• Register in runtime factory
• Documentation and usage examples
• Tests (unit + integration)

References

• Existing adapters: claude_code_adapter.py, codex_cli_adapter.py, opencode_adapter.py
• Pattern to follow: see src/ouroboros/providers/ and src/ouroboros/orchestrator/

PR Target Branch

Important: Please target your PRs to release/0.26.0-beta, not main.

[ouroboros-agent]

This looks like a multi-file runtime integration rather than a single narrow fix, so I’m routing it for design before implementation.

Scope assessment:

• Adds a new CLI provider adapter (GeminiCLIAdapter)
• Adds a new runtime/orchestrator integration (GeminiCLIRuntime)
• Requires event normalization for Gemini CLI streaming/output semantics
• Requires runtime factory registration and wiring
• Requires documentation and test coverage across unit/integration layers

That blast radius is larger than a single low-risk fix, and the first step is clarifying the runtime contract for Gemini CLI behavior before opening an implementation PR.

The repo does not currently appear to have a needs-design label configured, so I’m recording the routing decision here in the issue thread.

ouroboros-agent[bot]