# Gemini API CLI

> Gemini API CLI is an open-source agent skill for design and media. Call the Gemini API from the shell with gemini-api. It is available on Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose.

- **Kind:** Skill
- **Pricing:** Open source
- **Platforms:** Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
- **Website:** https://github.com/google-gemini/gemini-skills/tree/main/skills/gemini-api-cli
- **Repository:** https://github.com/google-gemini/gemini-skills
- **GitHub stars:** 4,510
- **License:** Apache-2.0
- **Skill name:** gemini-api-cli
- **Collection:** https://github.com/google-gemini/gemini-skills
- **Categories:** design and media, AI models and LLM tooling
- **Listing updated:** 2026-11-17

## About

Call the Gemini API from the shell with gemini-api. Use for media generation (images, TTS, music, video), file and YouTube analysis, audio/video transcription, Deep Research, and sandboxed agents.

## When your agent uses it

> Call the Gemini API from the shell with gemini-api. Use for media generation (images, TTS, music, video), file and YouTube analysis, audio/video transcription, Deep Research, and sandboxed agents.

## What it can access

From a static check of the files on GitHub; nothing was run.

- [Instructions only, no scripts](https://github.com/google-gemini/gemini-skills/tree/HEAD/skills/gemini-api-cli)
- [License: Apache-2.0](https://github.com/google-gemini/gemini-skills/tree/HEAD/skills/gemini-api-cli)

## Install

### Claude Code

This skill ships in the `gemini-skills` plugin. In Claude Code, add the marketplace and install the plugin (it may include other skills too):

```sh
/plugin marketplace add google-gemini/gemini-skills
/plugin install gemini-skills@gemini-skills
```

Or copy only this skill to `~/.claude/skills/gemini-api-cli`:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google-gemini/gemini-skills.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/gemini-api-cli &&
cp -R "$tmp/skills/gemini-api-cli" ~/.claude/skills/gemini-api-cli &&
rm -rf "$tmp"
```

For one project only, put the folder in `.claude/skills/gemini-api-cli` inside it instead.

### Codex

Copy the skill folder to `~/.agents/skills/gemini-api-cli` to use it in every repository:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google-gemini/gemini-skills.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/gemini-api-cli &&
cp -R "$tmp/skills/gemini-api-cli" ~/.agents/skills/gemini-api-cli &&
rm -rf "$tmp"
```

For one repository only, put the folder in `.agents/skills/gemini-api-cli` inside it instead.

### Cursor

Copy the skill folder to `~/.cursor/skills/gemini-api-cli` to use it in every project:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google-gemini/gemini-skills.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/gemini-api-cli &&
cp -R "$tmp/skills/gemini-api-cli" ~/.cursor/skills/gemini-api-cli &&
rm -rf "$tmp"
```

For one project only, put the folder in `.cursor/skills/gemini-api-cli` inside it instead.

### Gemini CLI

Run in a terminal (add `--scope workspace` to install it for the current workspace only):

```sh
gemini skills install https://github.com/google-gemini/gemini-skills.git --path skills/gemini-api-cli
```

Or copy the folder to `~/.gemini/skills/gemini-api-cli` yourself.

### VS Code

For GitHub Copilot in VS Code, copy the skill folder to `~/.copilot/skills/gemini-api-cli`:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google-gemini/gemini-skills.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/gemini-api-cli &&
cp -R "$tmp/skills/gemini-api-cli" ~/.copilot/skills/gemini-api-cli &&
rm -rf "$tmp"
```

For one project only, put the folder in `.github/skills/gemini-api-cli` inside it instead.

### Other agents

Get the folder:

```sh
git clone --depth 1 https://github.com/google-gemini/gemini-skills.git
```

Then copy `gemini-skills/skills/gemini-api-cli` into your agent's skills folder as `gemini-api-cli`. Agents that support SKILL.md read one folder per skill.

## FAQ

### How do I install Gemini API CLI in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/gemini-api-cli to use it in all your projects, or to .claude/skills/gemini-api-cli in one project. Or install the gemini-skills plugin, which includes it: /plugin marketplace add google-gemini/gemini-skills, then /plugin install gemini-skills@gemini-skills.

### Does Gemini API CLI run scripts?

No. It is instructions only, with no scripts. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

### Which AI agents can use Gemini API CLI?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

### What are the best alternatives to Gemini API CLI?

The closest alternatives to Gemini API CLI are Rea tool design, Codebase design, MCP builder, Claude API and Canvas design.

## Alternatives

- [Rea tool design](https://ai-powered.com/skills/rea-tool-design): Rea tool design is an open-source agent skill for design and media.
- [Codebase design](https://ai-powered.com/skills/codebase-design): Codebase design is an open-source agent skill for design and media.
- [MCP builder](https://ai-powered.com/skills/mcp-builder): MCP builder is an agent skill for ai models and llm tooling.
- [Claude API](https://ai-powered.com/skills/claude-api): Claude API is an agent skill for ai models and llm tooling.
- [Canvas design](https://ai-powered.com/skills/canvas-design): Canvas design is an agent skill for design and media.
- [Frontend design](https://ai-powered.com/skills/frontend-design): Frontend design is an agent skill for design and media.
- [Academy guide](https://ai-powered.com/skills/academy-guide): Academy guide is an agent skill for ai models and llm tooling.
- [Globestudio](https://ai-powered.com/skills/globestudio-github): Globestudio is an open-source agent skill for design and media.

---
Source: https://ai-powered.com/skills/gemini-api-cli
