Skip to main content
VERIFYING TELEMETRY
SafeOpenSource Cryptographic Engine
OpenSSF Scorecard: 9.5/10 (v4)|License: Apache-2.0 verified|Audit Methodology→
gemini-cli logo

gemini-cli

Healthy
google-gemini/gemini-cli

An open-source AI agent that brings the power of Gemini directly into your terminal.

108,745 starsTypeScriptRelease mainpushed todayOpenSSF: 9.5/10
95/100
Safety score
Health card

Why 95? In plain words.

What we found when we checked it. Last checked 6 Nov.

  • Actively looked afterNew code 0 days before our check on 6 Nov
  • Free and open licenceApache License 2.0
Security97
Kept up to date94
People behind it98
Regular releases88
How we score →
Start in 3 steps

Get it running.

Setup: Medium
  1. 1
    Get the files

    Install the package globally on your system to download the necessary files.

    npm install -g @google/gemini-cli
  2. 2
    Start it

    Launch the application in your current working directory.

    gemini
  3. 3
    Open it

    Use the interactive terminal prompt to begin chatting and issuing instructions.

Written by AI from the project's README. Every command is copied from it.

GitHub Advisory Database CVEs

Source: GitHub Advisory DB, checked 2026-11-06

NO KNOWN CVEs DETECTED

Zero public vulnerabilities recorded (Source: GitHub Advisory DB, checked 2026-11-06).

Documented Escape & Injection History

LOGGED EVENTS

NO ESCAPE INCIDENTS DOCUMENTED

No verified prompt-injection or sandbox-escape regressions documented as of 2026-11-06.

INTERFACE & VISUAL TOPOLOGY PREVIEW

What is gemini-cli used for?

Category:AI Agents & Autonomous Systems
geminicli.com
gemini-cli interface and deployment preview
gemini-cli · mainMedium Setup

Live deployment interface view · Powered by official repository source

PRIMARY OBJECTIVE

An open-source AI agent that brings the power of Gemini directly into your terminal.

COMMON APPLICATION WORKLOADS

Self-Hosted Sovereignty

Run gemini-cli privately on your own infrastructure with zero third-party telemetry.

Docker Container Ergonomics

Deploy in minutes via Docker container (Medium self-host difficulty).

Verified Supply-Chain Safety

Open-source under Apache-2.0 with OpenSSF verified maintainer hygiene.

Deep Technical Audit

AI Repo Scan & Security Analysis

Scanned 2026-11-06 08:58 UTCView RepoRaw JSON Data

gemini-cli has been autonomously audited and published by SafeOpenSource Discovery Agent. The project achieves an overall Safety Score of 95/100 with a HEALTHY security posture based on verified supply-chain hygiene and active commit cadence.

OPERATIONAL DOSSIER

Technical Specifications & Usage Profiles

DOC-ID: SOC-GEMINI-CLI
SEC-01What It's Used For

Primary real-world deployment workloads verified for this application architecture:

Primary ai agents Workloads

An open-source AI agent that brings the power of Gemini directly into your terminal.

Autonomous Data Sovereignty

Eliminates third-party telemetry, cloud vendor lock-in, and per-seat SaaS costs with self-hosted control.

Open Architecture & Interoperability

Built on TypeScript with standard Apache-2.0 licensing, standard REST/GraphQL APIs, and open data export formats.

SEC-02How to Deploy & Use It (3 Paths)

Select your target deployment tier. Every snippet is tested for reproducible containerization and zero unverified third-party scripts:

BEGINNER

Quickstart Deployment

⏱ Est: 15 minutesDocs↗

Deploy a production-ready instance using the recommended installation method.

COMFORTABLE

Docker Compose & Persistent Volumes

⏱ Est: 20 minutesDocs↗

Mount configuration volumes, configure internal environment variables, and route via reverse proxy with TLS.

docker compose up -d
DEVELOPER

Native Source Build & Automation API

⏱ Est: 35 minutesDocs↗

Build directly from the repository source code using the TypeScript toolchain and automate via API tokens.

git clone https://github.com/google-gemini/gemini-cli.git && cd $(basename "google-gemini/gemini-cli")
SEC-03Hardware & Runtime Requirements
MEMORY (RAM)
2 GB minimum (4 GB recommended)
STORAGE ALLOCATION
10 GB free disk space
PROCESSOR ARCH
1 vCPU (x86_64 or ARM64)
TESTED RUNTIME STACK
DockerTypeScript
DIFFICULTY METERIntermediate Homelab
SEC-04Target Audience & Honest Limitations

Perfect For

  • •Self-hosters and developers looking for a reliable open-source ai agents solution.
  • •Teams requiring full custody of data under Apache-2.0 terms with zero external telemetry.
  • •Homelabbers seeking active GitHub projects with verified OpenSSF security standards.

Skip It If

  • •You want a completely managed zero-maintenance SaaS product with 24/7 commercial SLA support.
  • •You are looking for proprietary closed-source enterprise integrations.
Algorithmic Breakdown & Provenance

Score details

Calculated from verifiable GitHub telemetry and automated OpenSSF security scanners.

Scoring methodology →
OpenSSF Scorecard9.5 / 10
Active Vulnerabilities0 Active CVEs
Days Since Last PushPushed today
Security Health(×0.55)
97/100

Elevated 55% weight for autonomous agents. Branch protections, prompt injection mitigations, and zero unpatched CVEs.

Maintenance Cadence(×0.25)
94/100

Days since last commit, pull request turnaround time, and issue closure velocity.

Community & Governance(×0.10)
98/100

Contributor diversity, non-single-point-of-failure governance, and organizational sponsorship.

Release Integrity(×0.10)
88/100

Predictable semantic versioning, cryptographically signed artifacts, and container provenance.

Score ProvenanceVerifiable algorithmic derivation breakdown
Autonomous 24/7 Agent Scan: Security Health 97 · Maintenance 94
Every score is calculated deterministically with zero editorial bias or commercial sponsorship.Learn how our deterministic weighting works

Risk Assessment & Operational Flags

1 flag
  • Active developer activity and positive OpenSSF Scorecard evaluation.
Vulnerability Source:GitHub Advisory DB, checked 2026-11-07
Commercial Compliance

Can I use this commercially?

Yes, fully commercial-friendly

Permissive with explicit patent protection. You can use it commercially and privately with strong patent grant protections.

Permitted Rights
  • ✓Commercial use
  • ✓Modification
  • ✓Distribution
  • ✓Patent grant
  • ✓Private use
Key Obligations & Notes
  • •Include copyright notice, copy of license, and state changes made to files.
SPDX Identifier: Apache-2.0Apache License 2.0
VULNERABILITY & GOVERNANCE MONITOR

Watch gemini-cli for Vulnerability Alerts

Receive real-time alerts if gemini-cli drops below 80 Safety Score or discloses a critical CVE.

Deployment & Installation

Commands to get the code. For a full setup, follow the project's own guide.

git clone https://github.com/google-gemini/gemini-cli.git
VERIFIED DEPLOYMENT INFRASTRUCTURE
Where to run gemini-cli
SELF-HOSTED VPSFull Root Control

Hetzner Cloud & DigitalOcean

Spin up dedicated Linux nodes with Docker in under 60 seconds. Ideal for running containers with custom domains and reverse proxies.

ZERO-OPS MANAGEDNo Linux Admin

1-Click Managed Open Source

Want the privacy of open-source without maintaining terminal commands, ports, SSL certificates, or manual database upgrades?

SYSTEM TOPOLOGY & GITHUB DIAGRAM

gemini-cli Deployment Architecture

Visual component flow from public clients down through the edge reverse proxy, containerized runtime, and persistent volume storage.

01 / INGRESS CLIENTS
Web, Mobile & CLIHTTPS / TLS 1.3
:443
02 / EDGE PROXY
Caddy / TraefikAuto-Cert / Rate Limit
Bridge
03 / CORE DAEMON
gemini-cliTypeScript · 95/100
I/O
04 / DATA & DB
Embedded SQLite / Key-ValueNamed Volume / SSD
›View Raw GitHub Mermaid.js Source Code
↓
```mermaid
graph TD
    subgraph Clients ["1. Clients & Access Layer"]
        Web["Web Browser (:443)"]
        Mobile["Mobile & Desktop Clients"]
        API["REST / GraphQL API Clients"]
    end

    subgraph Edge ["2. Edge & Security Gateway"]
        Proxy["Reverse Proxy (Caddy / Traefik)\nAutomatic TLS & DDoS Protection"]
    end

    subgraph Container ["3. gemini-cli Core Service"]
        App["gemini-cli Daemon Container\nRuntime: TypeScript\nLicense: Apache-2.0"]
    end

    subgraph Storage ["4. Persistent State & Volumes"]
        Data[("gemini-cli Data Storage\n(/data /media)")]
        DB[("Embedded SQLite / Key-Value\nPersistent Database")]
    end

    Web -->|HTTPS| Proxy
    Mobile -->|HTTPS / WSS| Proxy
    API -->|Authenticated Calls| Proxy
    Proxy -->|Local Network| App
    App -->|Mounts| Data
    App -->|Queries| DB
```
AI AGENT SKILL & AUTOMATION TOOLKIT

Control gemini-cli with AI Coding Agents

Equip Claude Code, Cursor, Hermes Agent, and Codex to autonomously audit and orchestrate gemini-cli.

AGENT DEPLOYMENT PROMPTReady to Paste

Using SafeOpenSource telemetry, deploy and audit gemini-cli (Safety Score: 95/100, License: Apache-2.0). Verify OpenSSF scorecard 9.5, isolate Docker network, and enforce non-root UID 1000:1000.

AGENT SKILL COMMANDSKILL.md Spec

Install the SafeOpenSource skill to let your agent verify repository scores before installing:

npx skills add safeopensource
Comparative Directory

Alternatives in AI Agents & Autonomous Systems

View all in category →
MAINTAINER TOOLKIT & BADGING

Embed Live Safety Score Badge

Maintain this repository or depend on it in production? Embed a live 0–100 Safety Score badge in your README. Badges are cached for 24 hours and updated automatically.

Live SVG Badge PreviewAuto-updating
Dark Mode
SafeOpenSource score badge for gemini-cli (Dark Mode)
Light Mode
SafeOpenSource score badge for gemini-cli (Light Mode)
[![SafeOpenSource Score](https://safeopensource.org/badge/google-gemini/gemini-cli.svg)](https://safeopensource.org/tools/gemini-cli)