What is agy-cli-agent?

A set of shell wrappers for running Google's Antigravity CLI, also called the Gemini CLI agent, without an interactive screen.

Use it to ask Antigravity to inspect a codebase, execute an implementation plan, run tasks in a chosen directory, or operate in CI and other headless environments.

It provides repeatable commands for running the agent in a repository, including read-only exploration, longer tasks, model selection, time limits, and multi-agent work.

agy-cli-agent — Skill for Claude Code and Codex by ImL1s: A set of shell wrappers for running Google's Antigravity…

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add skills/iml1s/agent-cli-skills/agy-cli-agent

Any agent

npx skills add ImL1s/agent-cli-skills --skill agy-cli-agent

Clone the repo

git clone --depth 1 https://github.com/ImL1s/agent-cli-skills

Made for: Claude Code, Codex.

Or install agent-cli-skills, the plugin that ships this one along with the rest of its 7 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/iml1s/agent-cli-skills/agy-cli-agent.svg)](https://agentmods.dev/skills/iml1s/agent-cli-skills/agy-cli-agent)

Your own site

<a href="https://agentmods.dev/skills/iml1s/agent-cli-skills/agy-cli-agent"><img src="https://agentmods.dev/badge/skills/iml1s/agent-cli-skills/agy-cli-agent.svg" alt="Measured on agentmods" height="20"></a>

Per session 106 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 852 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. Scan, not verified.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5	$0.00106	$0.00852
Opus 5	$0.00053	$0.00426
Sonnet 5	$0.00021	$0.00170
Haiku 4.5	$0.00011	$0.00085

Measured 4d ago against content hash e861ab6c86bc, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

agy-cli-agent scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

The scan reads SKILL.md. This mod also ships 6 executable files (agy-exec.sh, agy-explore.sh, agy-task.sh, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/agy-cli-agent/SKILL.md · 67 lines

How it starts

The opening of the file, as written. The whole thing — 67 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Antigravity CLI (`agy`) Executor

When to use

User wants agy / Antigravity as the coding agent
Orchestrator needs a headless agy run (pipes, CI, council seats)
Plan-executor / explore helpers (agy-task.sh, agy-explore.sh)

Prefer other *-cli-agent skills when the user names Claude, Codex, Grok, Kimi, or Qwen. For multi-provider parallel opinions, use multi-cli-spawn.

Wrapper

# From this skill directory (or after ./install.sh):
./agy-exec.sh -C /path/to/repo -t 900s "Implement the task; stop when done."
./agy-exec.sh -r -C /path/to/repo "Where is auth handled?"   # read-only
./agy-exec.sh -T -C /path/to/repo "Large refactor…"          # native multi-agent hint
./agy-task.sh -C /path/to/repo -v "npm test" "Do task X"
./agy-explore.sh -C /path/to/repo "How does routing work?"

Shared flags: -m model · -t print-timeout · -C cwd · -f prompt-file · -r read-only · -s sandbox · -T teamwork/subagent preamble · --agent · --mode · --effort · --add-dir · --no-git · -- passthrough to agy.

Default model: gemini-3.5-flash-high. Discover ids with agy models. -C is absolutized before use (relative paths are safe).

Critical: PTY required

agy -p prints nothing unless stdout is a real TTY (gemini-cli#76). This wrapper always uses lib/pty_run.py. Do not call bare agy -p from pipes/subprocesses.

Native multi-agent

Interactive: /teamwork-preview (Ultra plan preview), /agents panel, custom agents under .agents/agents/
Headless: -T adds a teamwork/subagent preamble; also --agent NAME
We do not reimplement teamwork — we ask agy to use its own orchestration when available

Git hazard

Prompts that mention git show / git diff / git checkout can cause agy to move HEAD. Prefer pre-computed diffs pasted into the prompt. Use --no-git. Orchestrator owns commits.

Discipline

Exit code is untrusted — verify with git diff + your done-criteria
Prefer disposable git worktrees for autonomous --dangerously-skip-permissions runs
One task = one agy -p (headless resume is unreliable)

Read the full file on GitHub · 67 lines

Files

What ships with it

6 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

4d ago First seen · 67 lines · 106 tokens per session scan A e861ab6c86bc

Subscribe to this mod's changes

agy-cli-agent is a skill published in the GitHub repository ImL1s/agent-cli-skills (2 stars, last pushed 1mo ago), licensed MIT. It adds 106 tokens to every session and 852 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Building agents agent-skills agents antigravity claude-code cli grok

search-boost

Multi-engine web search before external API/integration work. Use when verifying versions, SDK signatures, cloud quotas, or comparing libraries. Prefer over built-in searchweb.

Mr-remon219/search-boost · 37 tokens

agent-harness-fault-injection

Use when an agent workflow needs deterministic recovery evidence for sandbox, MCP/tool, worker, checkpoint, memory, or orchestration failures.

sickn33/agentic-awesome-skills · 34 tokens

aria

Designs the data model, API contracts, and structural foundation of the system.

sickn33/agentic-awesome-skills · 18 tokens

peon-ping-log

Log exercise reps for the Peon Trainer. Use when user says they did pushups, squats, or wants to log reps. Examples - "/peon-ping-log 25 pushups", "/peon-ping-log 30 squats", "log 50 pushups".

PeonPing/peon-ping · 64 tokens

agy-delegate

Delegate a coding task to the Google Antigravity CLI (agy) as a background implementer, then review its diff and land it yourself. Use this whenever the user wants to hand implementation work to Antigravity or agy - phrasings like "have Antigravity do X", "delegate this to agy", "run it through agy", or "use…

amElnagdy/delegate-skills · 132 tokens

conductor-implement

Executes the tasks defined in the specified track's plan. Use this to start or continue working on a feature, bug fix, or chore.

gemini-cli-extensions/conductor · 34 tokens