{"id":50726183,"url":"https://github.com/google-gemini/gemini-api-cli","last_synced_at":"2026-06-10T04:30:58.517Z","repository":{"id":362696681,"uuid":"1224715013","full_name":"google-gemini/gemini-api-cli","owner":"google-gemini","description":null,"archived":false,"fork":false,"pushed_at":"2026-06-05T13:20:16.000Z","size":257,"stargazers_count":20,"open_issues_count":0,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-06-05T15:07:25.055Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/google-gemini.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-29T14:54:25.000Z","updated_at":"2026-06-05T13:14:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/google-gemini/gemini-api-cli","commit_stats":null,"previous_names":["google-gemini/gemini-api-cli"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/google-gemini/gemini-api-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google-gemini%2Fgemini-api-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google-gemini%2Fgemini-api-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google-gemini%2Fgemini-api-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google-gemini%2Fgemini-api-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/google-gemini","download_url":"https://codeload.github.com/google-gemini/gemini-api-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google-gemini%2Fgemini-api-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34137570,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-10T04:30:57.929Z","updated_at":"2026-06-10T04:30:58.512Z","avatar_url":"https://github.com/google-gemini.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Experimental Gemini API CLI\n\n\u003e An experimental CLI for the Gemini API.\n\n## Features\n\n- **Model Interactions**: Run prompts against Gemini models with support for streaming, system instructions, and service tiers.\n- **Multimodal Support**: Handle image understanding, image generation, and text-to-speech (TTS).\n- **Agent Lifecycle**: Scaffold (`init`), deploy (`create`), test, and delete custom agents.\n- **Deep Research**: Support for long-running Deep Research tasks with automatic polling and reconnection.\n- **Tools**: Integrate tools like Code Execution and Google Search.\n- **Environment Management**: Download snapshots of agent environments and pass custom sources (inline, github, gcs) to agents.\n\n## Installation\n\n### Via Install Script (Recommended)\n\nYou can install the pre-compiled binary directly (no cloning required) using this single-line command:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/google-gemini/gemini-api-cli/main/scripts/install.sh | bash\n```\n\n### From Source (via npm/Node.js)\n\nIf you don't have Bun, you can install it as a Node.js package (requires Node.js ≥ 22):\n\n```bash\ngit clone https://github.com/google-gemini/gemini-api-cli.git\ncd gemini-api-cli\nnpm install -g .\n```\n\n### Quick Start (for development)\n\n```bash\n# Install dependencies\nbun install\n\n# Run in dev mode\nbun run dev -- run \"Hello\"\n\n# Build standalone binary for current platform\nbun run compile\n./dist/gemini-api --version\n```\n\n## Commands\n\n```bash\n# Run an interaction against a model\ngemini-api run \"What is the capital of France?\"\n\n# Scaffold, test, and deploy agents\ngemini-api agents init my-agent\ngemini-api agents test --prompt \"Hello\"\ngemini-api agents create\n\n# Manage environment files\ngemini-api files download \u003cenv-id\u003e\n```\n\n## E2E Tests\n\nWe have a suite of End-to-End (E2E) tests located in `tests/e2e/`.\nThese scripts run both the `--dry-run` variant (to show the command) and the live variant (to show the result).\n\nTo run a specific test:\n```bash\nbash tests/e2e/cuj_01.sh\n```\n\nSee [E2E.md](./tests/e2e/E2E.md) for a full list of Critical User Journeys and their status.\n\n## Skills\n\nThis repository includes a skill for AI agents to understand how to use this CLI.\n\n- [Gemini API CLI Skill](./skills/gemini-api-cli/SKILL.md) — Comprehensive guide for agents, covering:\n  - Normal model calls (text, multi-turn, tools)\n  - Agent lifecycle management (init, create, test, delete)\n  - Agent calls (invoking antigravity-preview-05-2026 and Deep Research)\n  - Genmedia (image generation, editing, TTS, music)\n\n\n\n## Documentation\n\n- [DOCS.md](./DOCS.md) — Full user guide and reference\n- [tests/e2e/E2E.md](./tests/e2e/E2E.md) — End-to-End Test Plan\n\n\n## Releasing New Versions\n\nTo release a new version and make the binaries available via the install script:\n\n1. Update the version in `package.json` and `src/cli.ts`.\n2. Commit and push the changes.\n3. Create a new Release on GitHub with a tag matching `v*` (e.g., `v0.2.0`).\n4. The **Release Binaries** GitHub workflow will automatically trigger, build the standalone binaries for all supported platforms, and upload them as assets to the release.\n\n## Licensing \u0026 Disclaimer\n\nCopyright 2026 Google LLC  \n\nAll software is licensed under the Apache License, Version 2.0 (Apache 2.0); you may not use this file except in compliance with the Apache 2.0 license. You may obtain a copy of the Apache 2.0 license at: [https://www.apache.org/licenses/LICENSE-2.0](https://www.apache.org/licenses/LICENSE-2.0)\n\nAll other materials are licensed under the Creative Commons Attribution 4.0 International License (CC-BY). You may obtain a copy of the CC-BY license at: [https://creativecommons.org/licenses/by/4.0/legalcode](https://creativecommons.org/licenses/by/4.0/legalcode)\n\nUnless required by applicable law or agreed to in writing, all software and materials distributed here under the Apache 2.0 or CC-BY licenses are distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the licenses for the specific language governing permissions and limitations under those licenses.\n\nThis is not an official Google product.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogle-gemini%2Fgemini-api-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoogle-gemini%2Fgemini-api-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogle-gemini%2Fgemini-api-cli/lists"}