# Install gemini-cli with Homebrew, MacPorts, Nix, pacman, zypper Interact with Google Gemini AI models from the command-line. Version 0.46.0 via Homebrew; verified 2026-06-15. ## Install ```sh sudo av install brew:gemini-cli ``` ## Agent safety answer gemini-cli is an AI CLI that can combine model access with local files and tool calls. - **Credential access:** Reads model API credentials, environment variables, and files included in prompts. - **Remote mutation:** Can drive local commands or API calls if granted tool access. - **Publish/artifact risk:** Can generate code and release commands that become artifacts. - **Recommended control:** Run in containment and gate all secret-backed or mutating commands. - **Agent-use guidance:** Limit file scope and require approval before exposing secrets or running deployment tools. Additional install commands: ### macOS - Homebrew (100%): ```sh brew install gemini-cli ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install gemini-cli ``` Evidence: MacPorts ports tree: llm/gemini-cli/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - Nix (92%): ```sh nix profile install nixpkgs#gemini-cli ``` Evidence: nixpkgs package indexes: pkgs/by-name/ge/gemini-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S gemini-cli ``` Evidence: Arch Linux sync databases: gemini-cli from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install gemini-cli ``` Evidence: openSUSE Tumbleweed package metadata: gemini-cli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ## Package facts - **Package key:** brew:gemini-cli - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.46.0 - **Source summary:** Interact with Google Gemini AI models from the command-line - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-06-15T10:20:17-04:00 - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - gemini (cli) - gemini (alias) ## Dependencies - node ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.46.0 - Package-manager updated: 2026-06-15 - Local data: ok - Upstream repository: https://geminicli.com - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage Gemini CLI is Google's open-source terminal agent for interacting with Gemini models from the command line. It became significant quickly because Google launched it as an Apache-2.0 project with free individual access, Code Assist integration, built-in tools, and package-manager distribution through npm and Homebrew. ### Project history Google announced Gemini CLI on June 25, 2025 as an open-source AI agent that brings Gemini into developers' terminals. The launch positioned the CLI as a local utility for coding, content generation, research, problem solving, and task management rather than only as a chat wrapper. The public repository developed around a terminal-first workflow: installation through npm or Homebrew, documented release channels, configuration through settings files and `GEMINI.md`, support for non-interactive invocation, and integration points such as MCP servers and extensions. ### Adoption history Gemini CLI's adoption path was tied to Google's Gemini Code Assist product line. The launch article stated that the tool shared technology with Gemini Code Assist, giving developers prompt-driven AI help in both VS Code and the terminal. Package-manager adoption followed the developer-tool pattern: the README documents global npm installation, `npx` execution, Homebrew installation, and MacPorts packaging. That made the CLI visible both to JavaScript users and to developers who expect AI tools to install like ordinary command-line utilities. ### How it is used Practitioners use Gemini CLI inside source trees to ask questions about code, edit files, run shell commands, debug failures, generate applications from multimodal inputs, and automate tasks from scripts. The tool also supports Google Search grounding, file operations, web fetching, conversation checkpointing, and project-specific context files. Teams use the CLI alongside Gemini Code Assist and GitHub workflows, while individual users often treat it as a terminal-native coding assistant that can operate without leaving the shell. ### Why package nerds care For package nerds, Gemini CLI is a marker of AI coding tools becoming ordinary CLI packages. It is distributed through language-package tooling and system package managers, has documented stable, preview, and nightly release channels, and exposes configuration paths that matter for reproducible developer environments. ### Timeline - 2025-06-25: Google announces Gemini CLI as an open-source AI agent for the terminal. - 2025: The repository publishes early preview, stable, and nightly release-channel tags. - 2025: Homebrew, MacPorts, npm, and other package-manager entries make the tool installable through common developer workflows. ### Related projects - Gemini CLI is related to Gemini Code Assist, Google AI Studio, Vertex AI, MCP servers, and the broader family of terminal AI agents used for code navigation and automation. ### Sources - - - - - ## Security Notes No matching local secret-handling manifest was found for gemini-cli. Nucleus package metadata is still published here so future coverage has a stable package URL. - **Approval gate rules:** 5 ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Linux: ~/.gemini/settings.json, .gemini/settings.json, /etc/gemini-cli/settings.json, /etc/gemini-cli/system-defaults.json - macOS: ~/.gemini/settings.json, .gemini/settings.json, /Library/Application Support/GeminiCli/settings.json, /Library/Application Support/GeminiCli/system-defaults.json - Windows: ~/.gemini/settings.json, .gemini/settings.json, C:\ProgramData\gemini-cli\settings.json, C:\ProgramData\gemini-cli\system-defaults.json ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** gemini-cli - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** yes - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Nix - gemini-cli: normalized package name match | nixpkgs package indexes: pkgs/by-name/ge/gemini-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman - gemini-cli - 1:0.45.2-1: normalized package name match | Arch Linux sync databases: gemini-cli from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Open-source AI agent that brings the power of Gemini directly into your terminal | https://github.com/google-gemini/gemini-cli - zypper - gemini-cli - 0.45.2-1.1: normalized package name match | openSUSE Tumbleweed package metadata: gemini-cli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | An AI agent that brings the power of Gemini directly into your terminal | https://github.com/google-gemini/gemini-cli - MacPorts - gemini-cli: normalized package name match | MacPorts ports tree: llm/gemini-cli/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew. - [kimi-cli](https://www.automicvault.com/pkg/brew/kimi-cli/) - Shares av.db curated category or tags: ai-agent, cli, developer-tool, developer-tools, terminal. - [claude-cmd](https://www.automicvault.com/pkg/brew/claude-cmd/) - Shares av.db curated category or tags: ai-coding, cli, developer-tools. - [claude-code-router](https://www.automicvault.com/pkg/brew/claude-code-router/) - Shares av.db curated category or tags: ai-coding, cli, developer-tools. - [claude-code-templates](https://www.automicvault.com/pkg/brew/claude-code-templates/) - Shares av.db curated category or tags: ai-coding, cli, developer-tools. - [claude-hooks](https://www.automicvault.com/pkg/brew/claude-hooks/) - Shares av.db curated category or tags: ai-coding, cli, developer-tools. - [claude-squad](https://www.automicvault.com/pkg/brew/claude-squad/) - Shares av.db curated category or tags: ai-coding, cli, developer-tools, terminal. - [claudekit](https://www.automicvault.com/pkg/brew/claudekit/) - Shares av.db curated category or tags: ai-coding, cli, developer-tools. - [cline](https://www.automicvault.com/pkg/brew/cline/) - Shares av.db curated category or tags: ai-coding, cli, developer-tools. - [qwen-code](https://www.automicvault.com/pkg/brew/qwen-code/) - Both packages touch the same language runtime or ecosystem. Shared terms: agent, ai, ai-coding, cli, coding. ## Combined YAML source View the package source record on GitHub. [combined/gemini-cli.yml](https://github.com/automic-vault/db/blob/main/combined/gemini-cli.yml) ## Sources - Nucleus package database - Geiger risk classifier - approval-gate seed metadata - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph - curated agent safety answer