Back to the catalog

claude-cope

A Gemini CLI plugin for when you can't cope without Claude.

Open source Open in the app JSON README (API)

About

A Gemini CLI plugin for when you can't cope without Claude.

Details

Kind
Plugins
Topic
AI, RAG & memory
Publisher
irken-empire
Origin
gemini
Category
ferramentas
Version
1.0.0
Forks
1
Last push
2026-03-10T01:26:31Z
Repository state
ativo
Language
TypeScript
License
Apache-2.0
Added
2026-08-30 14:13:39
Updated
2026-08-30 14:13:39
Origin id
irken-empire/claude-cope

README

# Claude Cope

> A Gemini CLI extension that pairs Gemini with Claude in an adversarial
> peer-review loop — _for when you can't cope without Claude._

Gemini builds. Claude reviews. You ship.

> [!WARNING]
> Even though this is an extension for the Gemini CLI,
> and not using any third-party tools, only Google APIs,
> Google still seems to block it with a _Terms of Service_ violation.
>
> _You have been warned._

## What it does

`claude-cope` adds a `/cope` slash command to Gemini CLI. When invoked, it:

1. Runs Gemini through four sequential phases: **PRD → Research → Plan → Implementation**
2. After each phase, calls Claude via the Antigravity Cloud Code API to adversarially review the output.

- If Claude `APPROVES`, moves to the next phase.
- If Claude requests `CHANGES_NEEDED`, Gemini iterates on the current phase until approved.

4. Sessions are persisted to `.claude-cope/` in your project so work survives restarts

## Installation

## Users

- Install the extension

```bash
gemini extensions install claude-cope
```

## Developers

```bash
# Install into Gemini CLI (live symlink — no re-install after changes)
gemini extensions link .
```

> [!WARNING]
> **Sandbox mode must be disabled.** The OAuth login flow requires a local
> HTTP callback server on port 7777. When `GEMINI_SANDBOX=true` (Docker
> sandbox), the browser cannot reach the container's `localhost`. Set
> `"sandbox": "none"` in `.gemini/settings.json` or `unset GEMINI_SANDBOX`.

## Usage

- Start a cope session — just describe what you want built

```bash
/cope Implement a YAML config system for user preferences
```

- Check status

```bash
/coping
```

- See token usage stats

```bash
/show-cope
```

- Pause and resume later

```bash
/uncope
/recope
```

## Documentation

| Doc                                    | Description                                     |
| -------------------------------------- | ----------------------------------------------- |
| [docs/spec.md](docs/spec.md)           | Full product specification                      |
| [docs/PLAN.md](docs/PLAN.md)           | Architecture and build plan                     |
| [docs/issues/todo/](docs/issues/todo/) | Open implementation issues                      |
| [docs/issues/done/](docs/issues/done/) | Completed issues                                |
| [docs/agents/](docs/agents/)           | Reference docs for AI agents (geminicli.txt, …) |
| [AGENTS.md](AGENTS.md)                 | Agent instructions and project internals        |

More