google-github-actions / google-github-actions/run-gemini-cli

A instabilidade do ambiente global: O caso do desaparecimento da Gemini CLI

Open
#456 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

1.0/windows-misc area/configuration area/tools kind/bug status/needs-triage
Dominant language
TypeScript
Stars
2.1k
Forks
285
Avg merge
8h 8m
Merged PRs (30d)
1

Description

Recentemente, enfrentei um problema crítico no meu ambiente de desenvolvimento que serve de alerta para todos que dependem de ferramentas globais via Node/NPM. De um dia para o outro, o comando gemini simplesmente parou de ser reconhecido pelo sistema, disparando o erro: 'gemini' não é reconhecido como um comando interno ou externo...

O Labirinto do Diagnóstico
O que parecia uma simples atualização de ambiente se tornou um "buraco de coelho" técnico:

Sumiço Inexplicável: O comando, que era parte integrante do meu workflow (especialmente para projetos como o Cidade Digital e automações de API), evaporou das Variáveis de Ambiente (PATH).

Conflito de Pacotes: Ao tentar reinstalar, encontrei uma confusão de nomes de pacotes (@google/generative-ai vs @google/generative-ai-docs vs gemini-chat-cli). Onde a SDK foi instalada com sucesso, a CLI (que provê o binário) falhava ou resultava em Erro 404.

Barreiras de Autenticação: O NPM passou a exigir tokens expirados para pacotes que deveriam ser públicos (npm notice Access token expired or revoked), travando o fluxo de recuperação.

Falha das Ferramentas Nativas: Ferramentas de reparo como winget não localizaram a instalação atual para upgrade, criando um estado de "limbo" onde o Node está na versão 22.20.0, mas os pacotes globais estão inacessíveis.

Reflexão Técnica
Este incidente reforça que ambientes de desenvolvimento no Windows, especialmente quando integrados a serviços de nuvem ou atualizações frequentes do Node, são frágeis. O PATH pode ser corrompido, e a gestão de pacotes globais do NPM ainda é um ponto único de falha.

Status atual: Em processo de reconstrução manual do PATH e mapeamento dos binários diretamente via npm config get prefix.

Alguém mais passou por esse reset de pacotes globais após o update do Node 22?

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

The report concerns a missing global Gemini CLI on Windows, Node 22.20.0, and the npm config get prefix entry point, but names no repository file or test. Start by determining whether the failure belongs to this GitHub Action, then reproduce the PATH and package-installation state; done should be a clearly scoped repository fix with a reproducible test.

Written by the indexing model from the issue text.

Assessment

Tech stack
nodejs
Domain
cli, tooling
Issue type
Bug
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
15/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.