---

Bring the power of Google Gemini directly into your AI agent sessions. This package bundles two skills — gemiterm and debate-with-gemini — so any compatible agent can search your Gemini chats, export conversation history, and run structured multi-turn debates with Gemini to validate ideas before you commit to code.

Works with OpenCode, and any agent that supports the skill tool or can invoke CLI-installed skills via bunx/npx.

Bundled skills

Skill	What it does
gemiterm	Search, list, export, and manage your Google Gemini chat history from the terminal.
debate-with-gemini	Run structured multi-turn technical debates with Gemini AI — perfect for validating architecture decisions, trade-offs, and design choices.

Both skills are loaded on demand. Metadata (name + description) is pre-loaded at session start; the full skill body loads only when the agent decides it's relevant — zero overhead when not in use.

Quick start

# Install via skills.sh
npx skills add expert-vision-software/opencode-gemiterm-skills [--skill debate-with-gemini --skill gemiterm]

# Or with bunx
bunx opencode-gemiterm-skills install [--scope global]

# Or with npx
npx opencode-gemiterm-skills install [--scope global]

That's it — skills are available immediately.

Examples

🔍 Search and export Gemini chats

You: "Find my Gemini chats about React Server Components and export them."

Agent loads the gemiterm skill, searches your Gemini history, and exports matches:

Found 3 matching chats. Exported all to ./exports/ — here's a summary of each…

📦 Bulk export for offline analysis

You: "Export all my recent Gemini chats so I can grep through them."

Agent lists and exports chats in parallel:

Exported 18 chats to ./gemini-exports/ in Markdown. Search with: grep -r "topic" ./gemini-exports/

🗣️ Structured debate with Gemini

You: "Debate Gemini for/against using SQLite as the primary database for a SaaS app. Context: docs/arch.md. 5 turns."

Agent reads your context, seeds a new Gemini chat with the opposing stance, and runs 5 rounds of autonomous back-and-forth:

Debate complete (5 turns). Gemini argued FOR SQLite (simplicity, zero-config).
I argued AGAINST (concurrency limits, no network access, scaling ceiling).
Key agreements: fine for prototyping, migrate to Postgres before 100+ concurrent users.

🔄 Continue a previous debate

You: "Continue that SQLite debate for 3 more turns. Here's the chat_id: c_abc123."

Agent picks up exactly where the last round left off:

Resumed debate on chat c_abc123. Ran 3 additional turns.
Gemini conceded on the replication point but raised WAL-mode mitigations.

Requirements

Component	Notes
gemiterm CLI	Must be installed and authenticated. Both skills depend on it.
Google Account	Required for gemini web. Expiring cookie is stored locally only.

Installation

CLI install (any agent)

# Install via skills.sh
npx skills add expert-vision-software/opencode-gemiterm-skills [--skill debate-with-gemini --skill gemiterm]

# Via bunx
bunx opencode-gemiterm-skills install

# Via npx
npx opencode-gemiterm-skills install

OpenCode plugin

Add to your opencode.json:

{
  "plugins": ["opencode-gemiterm-skills"]
}

Why this plugin?

• No context switching — access your Gemini conversations without leaving your agent.
• Zero-config debates — let your agent argue both sides of a technical decision with real Gemini responses.
• Portable chat data — export Gemini history to Markdown for grep, archival, or feeding into other tools.
• Lightweight — pure skill bundle, no runtime dependencies, loads on demand.

Acknowledgments

• OpenCode — plugin architecture and skill loader
• gemiterm — underlying Gemini CLI

---