Dianel555/DSkills / skills/cc-agy
cc-agy
FlaggedDelegates coding/research tasks to the Google Antigravity CLI (`agy`) for external-model execution (Gemini 3.x, Claude Sonnet/Opus 4.6, GPT-OSS). Replaces the broken `collaborating-with-gemini` skill. Use when: (1) External-model delegation via Antigravity, (2) Multi-model prototyping (switch model per call), (3) Backend/logic implementation, (4) Algorithm design and optimization, (5) Bug analysis and debugging, (6) API/database code generation, (7) Code review. Triggers: "delegate to agy", "use Antigravity", "external model", "agy", "Gemini 3.5", "Claude Sonnet 4.6", "GPT-OSS". IMPORTANT: Always request unified diff patches only. Supports multi-turn sessions via SESSION_ID.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 5.8 KB |
| SKILL.md | skill md | 6.5 KB |
| ruff.toml | config | 656 B |
| scripts/agy_bridge.py | script | 18.8 KB |
| tests/test_agy_bridge.py | script | 8.6 KB |
README.md
View on GitHub# cc-agy
A Claude Code **Agent Skill** that bridges Claude with the Google Antigravity CLI (`agy`) for external-model delegation(Gemini CLI stopped working for person).
## Overview
This Skill lets Claude delegate coding/research tasks to `agy`, which runs external models — Gemini 3.x, Claude Sonnet/Opus 4.6, GPT-OSS — with their own configured MCP servers, skills, and memory doc. Claude orchestrates the workflow and refines the output; agy executes on the external model.
`agy --print` writes nothing to stdout, so the bridge instead discovers the conversation SQLite DB that agy persists and extracts the assistant reply from its protobuf payload. When a run fails upstream, agy records the executor error in a separate `step_type=17` row instead of any reply text; the bridge reads that row and reports the real cause. MCP (`~/.gemini/antigravity/mcp_config.json`), the memory doc (`~/.gemini/GEMINI.md`), and skills are pre-configured by the user and auto-loaded by agy — the bridge does not manage them.
## Features
- **Multi-turn sessions**: Resume conversations via `SESSION_ID` (maps to agy `--conversation`)
- **Multi-model prototyping**: Switch model per call with `--model` aliases (flash, pro, sonnet, opus, gpt-oss)
- **JSON output**: Structured responses isomorphic to `gemini_bridge.py`
- **Cross-platform**: Windows path / UTF-8 handled automatically
- **Setup probe**: `check` subcommand reports agy install / version / auth / current model
- **Plugin passthrough**: `plugin` subcommand forwards to `agy plugin list|import|install|enable|disable`
## Prerequisites
1. Install the Antigravity CLI:
```bash
curl -fsSL https://antigravity.google/cli/install.sh | bash
```
2. Authenticate: run `agy` once interactively (browser OAuth), or export `ANTIGRAVITY_API_KEY`.
3. Pick a default model: open `agy` and use `/model`, which writes `~/.gemini/antigravity-cli/settings.json`.
Verify with:
```bash
python scripts/agy_bridge.py check
```
## Installation
Copy this Skill to your Claude Code skills directory:
- User-level: `~/.claude/skills/cc-agy/`
- Project-level: `.claude/skills/cc-agy/`
Or, in the DSkills marketplace, it is registered in `.claude-plugin/marketplace.json` as the `cc-agy` plugin.
## Usage
### Basic
```bash
python scripts/agy_bridge.py --cd "/path/to/project" --PROMPT "Analyze the authentication flow"
```
### Multi-turn Session
```bash
# Start a session
python scripts/agy_bridge.py --cd "/project" --PROMPT "Review login.py for security issues"
# Response includes SESSION_ID
# Continue the session
python scripts/agy_bridge.py --cd "/project" --SESSION_ID "uuid-from-response" --PROMPT "Suggest fixes for the issues found"
```
### Switch Model Per Call
```bash
python scripts/agy_bridge.py --cd "/project" --PROMPT "Review this Rust" --model sonnet
python scripts/agy_bridge.py --cd "/project" --PROMPT "Same code" --model opus
```
### Parameters
| Parameter | Required | Description |
|-----------|----------|-------------|
| `--PROMPT` | Yes | Task instruction |
| `--cd` | Yes | Workspace root (agy cwd + `--add-dir`) |
| `--model` | No | Model alias or canonical string; omit for settings default |
| `--SESSION_ID` | No | Resume a conversation by UUID (maps to `--conversation`) |
| `--sandbox` | No | Run in agy sandbox mode |
| `--no-skip-permissions` | No | Do NOT pass `--dangerously-skip-permissions` (WARNING: hangs print mode) |
| `--print-timeout` | No | agy `--print-timeout` (e.g. `5m`, `10m`); default `10m` |
| `--return-all-messages` | No | Include reasoning + all `type=15` steps |
Model aliases: `flash-low/medium/high`, `pro-low/high`, `sonnet`, `opus`, `gpt-oss`.
### Subcommands
| Subcommand | Description |
|------------|-------------|
| `check` | Probe agy install / version / auth / current model |
| `plugin` | Thin passthrough to `agy plugin list\|import\|install\|enable\|disable` |
### Output Format
```json
{
"success": true,
"SESSION_ID": "uuid",
"agent_messages": "agy response text"
}
```
When agy produces no reply, `error` carries agy's own upstream failure rather than a guess about the bridge:
```json
{
"success": false,
"SESSION_ID": "uuid",
"error": "agy produced no reply because the run failed upstream (rc=1): FAILED_PRECONDITION (code 400): User location is not supported for the API use.",
"steps_file": "/tmp/agy_steps_xxxx.jsonl"
}
```
Upstream failures are often transient (geo/egress-IP rejection, model capacity exhausted). The bridge does not retry — the status detail tells the caller whether to wait or switch `--model`.
## Security Note
By default the bridge passes `--dangerously-skip-permissions` to agy. This is **mandatory for non-interactive `--print` mode**: agy's default `toolPermission` is `request-review`, which blocks waiting for a human to approve tool calls, and `--print` captures no TTY — so the process hangs until timeout. With `--dangerously-skip-permissions`, agy auto-approves all tool calls. The bridge always runs under a hard outer timeout (`--print-timeout` + 60s) so a hung agy cannot block indefinitely. Only use `--no-skip-permissions` in a context where interactive permission prompts can be serviced.
## Known Limitations
- **Protobuf extraction is schema-dependent.** The reply is read from field `f1` inside field `f20` of `step_type=15` rows; upstream errors from `f24` → `f3` of `step_type=17` rows. If agy changes its internal schema, extraction returns empty. Fix location: `extract_answer()` (replies) or `extract_run_error()` (errors) in `scripts/agy_bridge.py`. The reported error names which one to fix, so trust it over guessing.
- `agy models` returns empty on this build; model aliases are hardcoded.
- `--continue` is intentionally not exposed (target selection is opaque); use `--SESSION_ID` to resume a specific conversation.
## License
MIT License. See [LICENSE](LICENSE) for details.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |