Back to the catalog

oi

Access Oi Contexts, Workflows, Skills, Guardrails, Brain, Connections, and reporting from Gemini CLI.

Open source Open in the app JSON README (API)

About

Access Oi Contexts, Workflows, Skills, Guardrails, Brain, Connections, and reporting from Gemini CLI.

Details

Kind
Plugins
Topic
AI, RAG & memory
Publisher
carhaix
Origin
gemini
Category
ferramentas
Version
2.0.0
Last push
2026-08-11T01:42:53Z
Repository state
ativo
Language
JavaScript
Added
2026-08-30 14:13:39
Updated
2026-08-30 14:13:39
Origin id
carhaix/oi-gemini

README

# <img src="https://www.oioioi.ai/brand/oi-icon.svg" alt="Oi Logo" style="width: 1em; height: 1em; vertical-align: -0.12em;" /> Oi - Gemini CLI and Antigravity

[Website](https://www.oioioi.ai) | [App](https://app.oioioi.ai)

Install Oi into Gemini CLI or Antigravity for shared Contexts, Workflows, Skills, Guardrails, Brain, Connections, and reporting.

You will need an Oi account and an Oi organization API key before connecting Oi.

Oi is provided as a hosted streamable HTTP MCP server at `https://api.oioioi.ai/mcp`.

## Gemini CLI

1. Install the extension:

```bash
gemini extensions install https://github.com/carhaix/oi-gemini
```

2. When prompted for `Oi API token`, paste an exported Oi organization API key.

3. Restart Gemini CLI so the extension MCP server is loaded.

4. Confirm the extension is installed:

```bash
gemini extensions list
```

5. Start Gemini CLI and ask it to use Oi:

```text
List the Oi contexts available to my team.
```

Gemini CLI exposes MCP tools with an `mcp_oi_` prefix internally. In normal use, you can simply ask Gemini to use Oi.

## Antigravity

1. Install the plugin:

```bash
agy plugin install https://github.com/carhaix/oi-gemini
```

2. Add your Oi organization API key to the installed plugin environment file:

```bash
OI_API_TOKEN=your_oi_api_key_here
```

The file is located at:

```text
~/.gemini/antigravity-cli/plugins/oi/.env
```

3. Restart Antigravity CLI.

4. Confirm the MCP server is connected:

```text
/mcp
```

Expected status:

```text
oi  connected
```

5. Ask Antigravity to use Oi:

```text
Use Oi to list my contexts.
```

If `/mcp` shows `Unauthorized [Auth Needed]`, Antigravity loaded the plugin but did not send a valid `Authorization` header to Oi. Confirm the `.env` file contains `OI_API_TOKEN` and restart Antigravity.

## Usage

After connecting Oi, ask Gemini CLI or Antigravity to use Oi for Context, Workflow, and Skill discovery and execution, Guardrail lifecycle operations, or connected-provider work:

```text
# list the Contexts available to your team
List the Oi contexts available to my team.

# list the Workflows available to your team
List the Oi workflows available to my team.

# recommend the best Context or Workflow for a task
Use Oi to recommend the best setup for reviewing this launch plan.

# use one Context for a focused task
Use the Oi designer context to review this onboarding flow.

# stack contexts to tackle complex problems
Use Oi with product-manager, designer, growth-lead, and software-engineer contexts to improve this onboarding flow.

# use one Workflow for a multi-step task
Use the Oi launch-readiness workflow to audit this release checklist before we ship.

# run a Skill available to your organization
Use Oi Skill customer-interview-synthesis on these interview notes.

# inspect connected providers before using one
Use Oi to list my Connections, then show the available actions for Linear.

# update durable organization or personal memory in Brain
Use Oi to remember this terminology for the organization.
Use Oi to remember this working preference for me.
```

## Update

Gemini CLI:

```bash
gemini extensions update oi
```

Antigravity:

```bash
agy plugin install https://github.com/carhaix/oi-gemini
```

## Uninstall

Gemini CLI:

```bash
gemini extensions uninstall oi
```

Antigravity:

```bash
agy plugin uninstall oi
```

## Files

- `gemini-extension.json` configures the Gemini CLI extension.
- `skills/oi/SKILL.md` teaches Gemini when and how to route work through the full Oi MCP surface.
- `plugin.json` and `mcp_config.json` configure the Antigravity plugin.

## Links

- [Oi MCP guide](https://www.oioioi.ai/guides/what-is-oi-mcp)
- [Gemini CLI extension docs](https://geminicli.com/docs/extensions/)
- [Gemini CLI releasing guide](https://geminicli.com/docs/extensions/releasing/)

More