Upgrade or switch to a preview release channel

getting started

// what it does

The npm package publishes three tags: @latest is the current stable release, @preview ships upcoming features earlier, and @nightly is built from main every day. Reinstall globally with the tag you want to move between channels. Check what you are on with gemini --version.

// shell

$ npm install -g @google/gemini-cli@latest
$ npm install -g @google/gemini-cli@preview
$ npm install -g @google/gemini-cli@nightly

// gotcha

@nightly can break without notice since it tracks unreleased code — keep it off machines you rely on. If you installed via Homebrew, npm install -g will not overwrite that copy cleanly; uninstall the brew formula first to avoid two gemini binaries on PATH.

// resources