Latest stable release: v0.21.0 - v0.21.1

Released: December 16, 2025

For most users, our latest stable release is the recommended release. Install the latest stable version with:

npm install -g @google/terminai

Highlights

⚡️⚡️⚡️ Gemini 3 Flash + TerminaI: If you are a paid user, you can now enable Gemini 3 Pro and Gemini 3 Flash. Go to /settings and set Preview Features to true to enable Gemini 3. For more information: Gemini 3 Flash is now available in TerminaI.

What’s Changed

refactor(stdio): always patch stdout and use createWorkingStdio for clean output by @allenhutchison in https://github.com/google-gemini/terminai/pull/14159
chore(release): bump version to 0.21.0-nightly.20251202.2d935b379 by @terminai-robot in https://github.com/google-gemini/terminai/pull/14409
implement fuzzy search inside settings by @sehoon38 in https://github.com/google-gemini/terminai/pull/13864
feat: enable message bus integration by default by @allenhutchison in https://github.com/google-gemini/terminai/pull/14329
docs: Recommend using —debug intead of —verbose for CLI debugging by @bbiggs in https://github.com/google-gemini/terminai/pull/14334
feat: consolidate remote MCP servers to use url in config by @jackwotherspoon in https://github.com/google-gemini/terminai/pull/13762
Restrict integration tests tools by @scidomino in https://github.com/google-gemini/terminai/pull/14403
track github repository names in telemetry events by @IamRiddhi in https://github.com/google-gemini/terminai/pull/13670
Allow telemetry exporters to GCP to utilize user’s login credentials, if requested by @mboshernitsan in https://github.com/google-gemini/terminai/pull/13778
refactor(editor): use const assertion for editor types with single source of truth by @amsminn in https://github.com/google-gemini/terminai/pull/8604
fix(security): Fix npm audit vulnerabilities in glob and body-parser by @afarber in https://github.com/google-gemini/terminai/pull/14090
Add new enterprise instructions by @chrstnb in https://github.com/google-gemini/terminai/pull/8641
feat(hooks): Hook Session Lifecycle & Compression Integration by @Edilmo in https://github.com/google-gemini/terminai/pull/14151
Avoid triggering refreshStatic unless there really is a banner to display. by @jacob314 in https://github.com/google-gemini/terminai/pull/14328
feat(hooks): Hooks Commands Panel, Enable/Disable, and Migrate by @Edilmo in https://github.com/google-gemini/terminai/pull/14225
fix: Bundle default policies for npx distribution by @allenhutchison in https://github.com/google-gemini/terminai/pull/14457
feat(hooks): Hook System Documentation by @Edilmo in https://github.com/google-gemini/terminai/pull/14307
Fix tests by @scidomino in https://github.com/google-gemini/terminai/pull/14458
feat: add scheduled workflow to close stale issues by @galz10 in https://github.com/google-gemini/terminai/pull/14404
feat: Support Extension Hooks with Security Warning by @abhipatel12 in https://github.com/google-gemini/terminai/pull/14460
feat: Add enableAgents experimental flag by @adamfweidman in https://github.com/google-gemini/terminai/pull/14371
docs: fix typo ‘socus’ to ‘focus’ in todos.md by @Viktor286 in https://github.com/google-gemini/terminai/pull/14374
Markdown export: move the emoji to the end of the line by @mhansen in https://github.com/google-gemini/terminai/pull/12278
fix(acp): prevent unnecessary credential cache clearing on re-authent… by @h-michael in https://github.com/google-gemini/terminai/pull/9410
fix(cli): Fix word navigation for CJK characters by @SandyTao520 in https://github.com/google-gemini/terminai/pull/14475
Remove example extension by @chrstnb in https://github.com/google-gemini/terminai/pull/14376
Add commands for listing and updating per-extension settings by @chrstnb in https://github.com/google-gemini/terminai/pull/12664
chore(tests): remove obsolete test for hierarchical memory by @pareshjoshij in https://github.com/google-gemini/terminai/pull/13122
feat(cli): support /copy in remote sessions using OSC52 by @ismellpillows in https://github.com/google-gemini/terminai/pull/13471
Update setting search UX by @Adib234 in https://github.com/google-gemini/terminai/pull/14451
Fix(cli): Improve Homebrew update instruction to specify terminai by @DaanVersavel in https://github.com/google-gemini/terminai/pull/14502
do not toggle the setting item when entering space by @sehoon38 in https://github.com/google-gemini/terminai/pull/14489
fix: improve retry logic for fetch errors and network codes by @megha1188 in https://github.com/google-gemini/terminai/pull/14439
remove unused isSearching field by @sehoon38 in https://github.com/google-gemini/terminai/pull/14509
feat(mcp): add --type alias for --transport flag in gemini mcp add by @jackwotherspoon in https://github.com/google-gemini/terminai/pull/14503
feat(cli): Move key restore logic to core by @cocosheng-g in https://github.com/google-gemini/terminai/pull/13013
feat: add auto-execute on Enter behavior to argumentless MCP prompts by @jackwotherspoon in https://github.com/google-gemini/terminai/pull/14510
fix(shell): cursor visibility when using interactive mode by @aswinashok44 in https://github.com/google-gemini/terminai/pull/14095
Adding session id as part of json o/p by @MJjainam in https://github.com/google-gemini/terminai/pull/14504
fix(extensions): resolve GitHub API 415 error for source tarballs by @jpoehnelt in https://github.com/google-gemini/terminai/pull/13319
fix(client): Correctly latch hasFailedCompressionAttempt flag by @pareshjoshij in https://github.com/google-gemini/terminai/pull/13002
Disable flaky extension reloading test on linux by @chrstnb in https://github.com/google-gemini/terminai/pull/14528
Add support for MCP dynamic tool update by notifications/tools/list_changed by @Adib234 in https://github.com/google-gemini/terminai/pull/14375
Fix privacy screen for legacy tier users by @scidomino in https://github.com/google-gemini/terminai/pull/14522
feat: Exclude maintainer labeled issues from stale issue closer by @galz10 in https://github.com/google-gemini/terminai/pull/14532
Grant chained workflows proper permission. by @scidomino in https://github.com/google-gemini/terminai/pull/14534
Make trigger_e2e manually fireable. by @scidomino in https://github.com/google-gemini/terminai/pull/14547
Write e2e status to local repo not forked repo by @scidomino in https://github.com/google-gemini/terminai/pull/14549
Fixes [API Error: Cannot read properties of undefined (reading ‘error’)] by @silviojr in https://github.com/google-gemini/terminai/pull/14553
Trigger chained e2e tests on all pull requests by @scidomino in https://github.com/google-gemini/terminai/pull/14551
Fix bug in the shellExecutionService resulting in both truncation and 3X bloat by @jacob314 in https://github.com/google-gemini/terminai/pull/14545
Fix issue where we were passing the model content reflecting terminal line wrapping. by @jacob314 in https://github.com/google-gemini/terminai/pull/14566
chore/release: bump version to 0.21.0-nightly.20251204.3da4fd5f7 by @terminai-robot in https://github.com/google-gemini/terminai/pull/14476
feat(sessions): use 1-line generated session summary to describe sessions by @jackwotherspoon in https://github.com/google-gemini/terminai/pull/14467
Use Robot PAT for chained e2e merge queue skipper by @scidomino in https://github.com/google-gemini/terminai/pull/14585
fix(core): improve API response error handling and retry logic by @mattKorwel in https://github.com/google-gemini/terminai/pull/14563
Docs: Model routing clarification by @jkcinouye in https://github.com/google-gemini/terminai/pull/14373
expose previewFeatures flag in a2a by @sehoon38 in https://github.com/google-gemini/terminai/pull/14550
Fix emoji width in debug console. by @jacob314 in https://github.com/google-gemini/terminai/pull/14593
Fully detach autoupgrade process by @scidomino in https://github.com/google-gemini/terminai/pull/14595
Docs: Update Gemini 3 on TerminaI documentation by @jkcinouye in https://github.com/google-gemini/terminai/pull/14601
Disallow floating promises. by @gundermanc in https://github.com/google-gemini/terminai/pull/14605
chore/release: bump version to 0.21.0-nightly.20251207.025e450ac by @terminai-robot in https://github.com/google-gemini/terminai/pull/14662
feat(modelAvailabilityService): integrate model availability service into backend logic by @adamfweidman in https://github.com/google-gemini/terminai/pull/14470
Add prompt_id propagation in a2a-server task by @koxkox111 in https://github.com/google-gemini/terminai/pull/14581
Fix: Prevent freezing in non-interactive TerminaI when debug mode is enabled by @parthasaradhie in https://github.com/google-gemini/terminai/pull/14580
fix(audio): improve reading of audio files by @jackwotherspoon in https://github.com/google-gemini/terminai/pull/14658
Update automated triage workflow to stop assigning priority labels by @skeshive in https://github.com/google-gemini/terminai/pull/14717
set failed status when chained e2e fails by @scidomino in https://github.com/google-gemini/terminai/pull/14725
feat(github action) Triage and Label Pull Requests by Size and Comple… by @DaanVersavel in https://github.com/google-gemini/terminai/pull/5571
refactor(telemetry): Improve previous PR that allows telemetry to use the CLI auth and add testing by @mboshernitsan in https://github.com/google-gemini/terminai/pull/14589
Always set status in chained_e2e workflow by @scidomino in https://github.com/google-gemini/terminai/pull/14730
feat: Add OTEL log event gemini_cli.startup_stats for startup stats. by @kevin-ramdass in https://github.com/google-gemini/terminai/pull/14734
feat: auto-execute on slash command completion functions by @jackwotherspoon in https://github.com/google-gemini/terminai/pull/14584
Docs: Proper release notes by @jkcinouye in https://github.com/google-gemini/terminai/pull/14405
Add support for user-scoped extension settings by @chrstnb in https://github.com/google-gemini/terminai/pull/13748
refactor(core): Improve environment variable handling in shell execution by @galz10 in https://github.com/google-gemini/terminai/pull/14742
Remove old E2E Workflows by @scidomino in https://github.com/google-gemini/terminai/pull/14749
fix: handle missing local extension config and skip hooks when disabled by @abhipatel12 in https://github.com/google-gemini/terminai/pull/14744
chore/release: bump version to 0.21.0-nightly.20251209.ec9a8c7a7 by @terminai-robot in https://github.com/google-gemini/terminai/pull/14751
feat: Add support for MCP Resources by @MrLesk in https://github.com/google-gemini/terminai/pull/13178
Always set pending status in E2E tests by @scidomino in https://github.com/google-gemini/terminai/pull/14756
fix(lint): upgrade pip and use public pypi for yamllint by @allenhutchison in https://github.com/google-gemini/terminai/pull/14746
fix: use LLM API supported image formats for clipboard by @jackwotherspoon in https://github.com/google-gemini/terminai/pull/14762
feat(a2a): Introduce restore command for a2a server by @cocosheng-g in https://github.com/google-gemini/terminai/pull/13015
allow final:true to be returned on a2a server edit calls. by @DavidAPierce in https://github.com/google-gemini/terminai/pull/14747
(fix) Automated pr labeller by @DaanVersavel in https://github.com/google-gemini/terminai/pull/14788
Update CODEOWNERS by @kklashtorny1 in https://github.com/google-gemini/terminai/pull/14830
Docs: Fix errors preventing site rebuild. by @jkcinouye in https://github.com/google-gemini/terminai/pull/14842
chore(deps): bump express from 5.1.0 to 5.2.0 by @dependabot[bot] in https://github.com/google-gemini/terminai/pull/14325
fix(patch): cherry-pick 3f5f030 to release/v0.21.0-preview.0-pr-14843 to patch version v0.21.0-preview.0 and create version 0.21.0-preview.1 by @terminai-robot in https://github.com/google-gemini/terminai/pull/14851
fix(patch): cherry-pick ee6556c to release/v0.21.0-preview.1-pr-14691 to patch version v0.21.0-preview.1 and create version 0.21.0-preview.2 by @terminai-robot in https://github.com/google-gemini/terminai/pull/14908
fix(patch): cherry-pick 54de675 to release/v0.21.0-preview.2-pr-14961 by @terminai-robot in https://github.com/google-gemini/terminai/pull/14968
fix(patch): cherry-pick 12cbe32 to release/v0.21.0-preview.3-pr-15000 to patch version v0.21.0-preview.3 and create version 0.21.0-preview.4 by @terminai-robot in https://github.com/google-gemini/terminai/pull/15003
fix(patch): cherry-pick edbe548 to release/v0.21.0-preview.4-pr-15007 to patch version v0.21.0-preview.4 and create version 0.21.0-preview.5 by @terminai-robot in https://github.com/google-gemini/terminai/pull/15015
fix(patch): cherry-pick 2995af6 to release/v0.21.0-preview.5-pr-15131 to patch version v0.21.0-preview.5 and create version 0.21.0-preview.6 by @terminai-robot in https://github.com/google-gemini/terminai/pull/15153

Full Changelog: https://github.com/google-gemini/terminai/compare/v0.20.2…v0.21.0

Changelog

Preview