Reading the repo

Opening the box…

How to install gemini-cli on Linux (google-gemini/gemini-cli) · gitmanual

How to install on Linux

google-gemini/gemini-cli

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

Node.js#ai#ai-agents#cli#gemini

Fresh setup, read just now

Will it work on my device?

Checking for

Homebrew

brew install gemini-cli

From the README, exactly as the maintainers wrote it.

No reports for Linux yet.

Opens a chat with this manual already filled in, for Linux. It uses your own account; gitmanual sends nothing.

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/google-gemini/gemini-cli/badge.svg)](https://gitmanual.com/google-gemini/gemini-cli)

Monorepo (workspaces) — install from the repo root.
Dockerfile available (base image: docker.io/library/node:20-slim).
Makefile has a make install target — it may automate most of these steps.
Nested projects: packages/a2a-server/package.json, packages/cli/package.json, packages/cli/src/commands/extensions/examples/mcp-server/package.json, packages/core/package.json and 10 more

startcross-env NODE_ENV=development node scripts/start.js
start:prodcross-env NODE_ENV=production node scripts/start.js
start:a2a-serverCODER_AGENT_PORT=41242 npm run start --workspace @google/gemini-cli-a2a-server
debugcross-env DEBUG=1 node --inspect-brk scripts/start.js
deflakenode scripts/deflake.js
deflake:test:integration:sandbox:nonenpm run deflake -- --command="npm run test:integration:sandbox:none -- --retry=0"
deflake:test:integration:sandbox:dockernpm run deflake -- --command="npm run test:integration:sandbox:docker -- --retry=0"
auth:npmnpx google-artifactregistry-auth
auth:dockergcloud auth configure-docker us-west1-docker.pkg.dev
authnpm run auth:npm && npm run auth:docker
generatenode scripts/generate-git-commit-info.js
predocs:settingsnpm run build --workspace @google/gemini-cli-core
schema:settingstsx ./scripts/generate-settings-schema.ts
docs:settingstsx ./scripts/generate-settings-doc.ts
docs:keybindingstsx ./scripts/generate-keybindings-doc.ts
eval:validatetsx ./scripts/eval-validate-cli.ts
eval:inventorytsx ./scripts/eval-inventory-cli.ts
eval:inventory:jsontsx ./scripts/eval-inventory-cli.ts --json
eval:reporttsx ./scripts/eval-report-cli.ts
eval:coveragetsx ./scripts/eval-coverage-cli.ts
buildnode scripts/build.js
build-and-startnpm run build && npm run start --
build:vscodenode scripts/build_vscode_companion.js
build:allnpm run build && npm run build:sandbox && npm run build:vscode
build:packagesnpm run build --workspaces

.github/workflows/agent-session-drift-check.yml

.github/workflows/build-unsigned-mac-binaries.yml

.github/workflows/ci.yml

.github/workflows/docs-rebuild.yml

.github/workflows/smoke-test.yml

.github/workflows/test-build-binary.yml

.nvmrc

Dockerfile

Makefile

README.md

docs/local-development.md

package.json

Branch main · 3,055 files in the repo