@mmmbuto/gemini-cli-termux 0.42.0-termux → 0.46.0-termux

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (79) hide show
  1. package/README.md +22 -2
  2. package/bundle/builtin/antigravity-support/SKILL.md +58 -0
  3. package/bundle/{chunk-BF6DCDLJ.js → chunk-4TSWR3AN.js} +145 -55
  4. package/bundle/{chunk-PL5MCDGY.js → chunk-6HI7VNOG.js} +55 -70
  5. package/bundle/{chunk-6PXDEURC.js → chunk-7QZTHDKK.js} +2 -4
  6. package/bundle/{chunk-ORXUJRZC.js → chunk-B7I47N5E.js} +3 -3
  7. package/bundle/{chunk-EHTAR2YP.js → chunk-G2G6HEZZ.js} +1 -1
  8. package/bundle/{chunk-LX6GOGBA.js → chunk-IB4Q6NBY.js} +123186 -73766
  9. package/bundle/{chunk-MP2YMAMR.js → chunk-IT3YFQ3I.js} +1 -1
  10. package/bundle/{chunk-RJTRUG2J.js → chunk-TUDYL3X4.js} +29 -5
  11. package/bundle/{chunk-A6KCGXPK.js → chunk-WUVOS6TV.js} +13 -6
  12. package/bundle/{chunk-SLMD2AMF.js → chunk-YGU42N5I.js} +847 -655
  13. package/bundle/{cleanup-RTDYF5DD.js → cleanup-GEP2OOHM.js} +4 -5
  14. package/bundle/{devtools-ZLHMA45S.js → devtools-V7NE4CQA.js} +1 -1
  15. package/bundle/{devtoolsService-SKRXJOXW.js → devtoolsService-EVM2JJLB.js} +5 -6
  16. package/bundle/{dist-B3HBIK36.js → dist-R3LOFA4X.js} +331 -285
  17. package/bundle/docs/changelogs/index.md +59 -0
  18. package/bundle/docs/changelogs/latest.md +201 -167
  19. package/bundle/docs/changelogs/preview.md +45 -102
  20. package/bundle/docs/cli/auto-memory.md +61 -40
  21. package/bundle/docs/cli/gemini-md.md +0 -2
  22. package/bundle/docs/cli/plan-mode.md +0 -1
  23. package/bundle/docs/cli/settings.md +19 -19
  24. package/bundle/docs/cli/tutorials/memory-management.md +3 -3
  25. package/bundle/docs/extensions/reference.md +16 -0
  26. package/bundle/docs/extensions/releasing.md +58 -24
  27. package/bundle/docs/extensions/writing-extensions.md +7 -0
  28. package/bundle/docs/get-started/installation.mdx +2 -2
  29. package/bundle/docs/issue-and-pr-automation.md +29 -1
  30. package/bundle/docs/reference/commands.md +0 -3
  31. package/bundle/docs/reference/configuration.md +173 -78
  32. package/bundle/docs/reference/keyboard-shortcuts.md +23 -0
  33. package/bundle/docs/reference/tools.md +0 -2
  34. package/bundle/docs/tools/mcp-server.md +24 -3
  35. package/bundle/docs/tools/memory.md +10 -13
  36. package/bundle/examples/custom-commands/commands/fs/grep-code.toml +6 -0
  37. package/bundle/examples/custom-commands/gemini-extension.json +4 -0
  38. package/bundle/examples/exclude-tools/gemini-extension.json +5 -0
  39. package/bundle/examples/hooks/gemini-extension.json +4 -0
  40. package/bundle/examples/hooks/hooks/hooks.json +14 -0
  41. package/bundle/examples/hooks/scripts/on-start.js +8 -0
  42. package/bundle/examples/mcp-server/README.md +35 -0
  43. package/bundle/examples/mcp-server/example.js +60 -0
  44. package/bundle/examples/mcp-server/gemini-extension.json +11 -0
  45. package/bundle/examples/mcp-server/package.json +11 -0
  46. package/bundle/examples/policies/README.md +41 -0
  47. package/bundle/examples/policies/gemini-extension.json +5 -0
  48. package/bundle/examples/policies/policies/policies.toml +28 -0
  49. package/bundle/examples/skills/gemini-extension.json +4 -0
  50. package/bundle/examples/skills/skills/greeter/SKILL.md +7 -0
  51. package/bundle/examples/themes-example/README.md +31 -0
  52. package/bundle/examples/themes-example/gemini-extension.json +29 -0
  53. package/bundle/{gemini-NJWIVDFH.js → gemini-SGAFQX2R.js} +450 -297
  54. package/bundle/gemini.js +18 -13
  55. package/bundle/{dist-T73EYRDX.js → https-proxy-agent-AVGR4LHR.js} +8 -3
  56. package/bundle/{interactiveCli-QHKQZZJU.js → interactiveCli-MEEXSI2X.js} +1922 -1675
  57. package/bundle/{liteRtServerManager-USDJEPCM.js → liteRtServerManager-3EZO3JZ5.js} +6 -7
  58. package/bundle/{oauth2-provider-ARATJNEE.js → oauth2-provider-AJMTKEL6.js} +8 -10
  59. package/bundle/package.json +1 -1
  60. package/bundle/policies/plan.toml +1 -1
  61. package/bundle/policies/write.toml +0 -7
  62. package/bundle/src-LG4OHBW7.js +343 -0
  63. package/bundle/{start-IWR7MCIR.js → start-YW7YIVR7.js} +8 -9
  64. package/bundle/worker/worker-entry.js +7863 -0
  65. package/package.json +3 -3
  66. package/bundle/chunk-2X6HJV2G.js +0 -52710
  67. package/bundle/memoryDiscovery-EEGUKQ5C.js +0 -29
  68. package/bundle/node_modules/@google/gemini-cli-devtools/dist/client/main.js +0 -96
  69. package/bundle/node_modules/@google/gemini-cli-devtools/dist/src/_client-assets.d.ts +0 -7
  70. package/bundle/node_modules/@google/gemini-cli-devtools/dist/src/_client-assets.js +0 -9
  71. package/bundle/node_modules/@google/gemini-cli-devtools/dist/src/_client-assets.js.map +0 -1
  72. package/bundle/node_modules/@google/gemini-cli-devtools/dist/src/index.d.ts +0 -48
  73. package/bundle/node_modules/@google/gemini-cli-devtools/dist/src/index.js +0 -333
  74. package/bundle/node_modules/@google/gemini-cli-devtools/dist/src/index.js.map +0 -1
  75. package/bundle/node_modules/@google/gemini-cli-devtools/dist/src/types.d.ts +0 -36
  76. package/bundle/node_modules/@google/gemini-cli-devtools/dist/src/types.js +0 -7
  77. package/bundle/node_modules/@google/gemini-cli-devtools/dist/src/types.js.map +0 -1
  78. package/bundle/node_modules/@google/gemini-cli-devtools/package.json +0 -33
  79. package/bundle/policies/memory-manager.toml +0 -20
@@ -154,7 +154,35 @@ and will never be auto-unassigned.
154
154
  - **Unassign yourself** if you can no longer work on the issue by commenting
155
155
  `/unassign`, so other contributors can pick it up right away.
156
156
 
157
- ### 6. Release automation
157
+ ### 6. Automatically label PRs by size: `PR Size Labeler`
158
+
159
+ To help maintainers estimate review effort and keep the PR history clean, this
160
+ workflow automatically tags every pull request with a size label representing
161
+ the total volume of line changes.
162
+
163
+ - **Workflow File**: `.github/workflows/pr-size-labeler.yml`
164
+ - **When it runs**: Immediately after a pull request is created, synchronized
165
+ (new commits pushed), or reopened. It can also be triggered manually via
166
+ `workflow_dispatch` with a PR number.
167
+ - **What it does**:
168
+ - **Calculates total changes**: Summarizes additions and deletions across all
169
+ changed files in a single consolidated API request.
170
+ - **Applies standard size labels**:
171
+ - `size/XS`: < 10 lines changed
172
+ - `size/S`: 10-49 lines changed
173
+ - `size/M`: 50-249 lines changed
174
+ - `size/L`: 250-999 lines changed
175
+ - `size/XL`: >= 1000 lines changed
176
+ - **Updates size tag atomically**: Adds the new correct size label and removes
177
+ any obsolete size labels in one atomic step.
178
+ - **Updates/Posts PR size info comment**: Instead of spamming a new comment on
179
+ every commit push, it updates the existing size labeler status comment
180
+ inline to keep the PR conversation timeline perfectly neat and clean.
181
+ - **What you should do**:
182
+ - You do not need to take any actions. The workflow runs automatically and
183
+ updates the label and comment seamlessly as you push new updates.
184
+
185
+ ### 7. Release automation
158
186
 
159
187
  This workflow handles the process of packaging and publishing new versions of
160
188
  Gemini CLI.
@@ -265,9 +265,6 @@ Slash commands provide meta-level control over the CLI itself.
265
265
  - **Description:** Manage the AI's instructional context (hierarchical memory
266
266
  loaded from `GEMINI.md` files).
267
267
  - **Sub-commands:**
268
- - **`add`**:
269
- - **Description:** Adds the following text to the AI's memory. Usage:
270
- `/memory add <text to remember>`
271
268
  - **`list`**:
272
269
  - **Description:** Lists the paths of the GEMINI.md files in use for
273
270
  hierarchical memory.
@@ -105,9 +105,19 @@ their corresponding top-level category object in your `settings.json` file.
105
105
 
106
106
  #### `general`
107
107
 
108
- - **`general.preferredEditor`** (string):
109
- - **Description:** The preferred editor to open files in.
108
+ - **`general.preferredEditor`** (enum):
109
+ - **Description:** The preferred editor to open files in. Must be one of the
110
+ built-in supported identifiers. Use /editor in the CLI to pick
111
+ interactively, or leave unset to use $VISUAL/$EDITOR.
110
112
  - **Default:** `undefined`
113
+ - **Values:** `"vscode"`, `"vscodium"`, `"windsurf"`, `"cursor"`, `"zed"`,
114
+ `"antigravity"`, `"sublimetext"`, `"lapce"`, `"nova"`, `"bbedit"`, `"vim"`,
115
+ `"neovim"`, `"emacs"`, `"hx"`, `"emacsclient"`, `"micro"`
116
+
117
+ - **`general.openEditorInNewWindow`** (boolean):
118
+ - **Description:** Open VS Code-family editors in a new window when editing
119
+ files.
120
+ - **Default:** `false`
111
121
 
112
122
  - **`general.vimMode`** (boolean):
113
123
  - **Description:** Enable Vim keybindings
@@ -203,6 +213,11 @@ their corresponding top-level category object in your `settings.json` file.
203
213
  chattiness and structured progress reporting.
204
214
  - **Default:** `true`
205
215
 
216
+ - **`general.logRagSnippets`** (boolean):
217
+ - **Description:** Log full Code Customization (RAG) retrieved snippets to a
218
+ local file for debugging.
219
+ - **Default:** `false`
220
+
206
221
  #### `output`
207
222
 
208
223
  - **`output.format`** (enum):
@@ -545,6 +560,24 @@ their corresponding top-level category object in your `settings.json` file.
545
560
  "model": "gemini-3-flash-preview"
546
561
  }
547
562
  },
563
+ "gemini-3.1-pro-preview": {
564
+ "extends": "chat-base-3",
565
+ "modelConfig": {
566
+ "model": "gemini-3.1-pro-preview"
567
+ }
568
+ },
569
+ "gemini-3.1-pro-preview-customtools": {
570
+ "extends": "chat-base-3",
571
+ "modelConfig": {
572
+ "model": "gemini-3.1-pro-preview-customtools"
573
+ }
574
+ },
575
+ "gemini-3.1-flash-lite-preview": {
576
+ "extends": "chat-base-3",
577
+ "modelConfig": {
578
+ "model": "gemini-3.1-flash-lite-preview"
579
+ }
580
+ },
548
581
  "gemini-2.5-pro": {
549
582
  "extends": "chat-base-2.5",
550
583
  "modelConfig": {
@@ -563,6 +596,18 @@ their corresponding top-level category object in your `settings.json` file.
563
596
  "model": "gemini-2.5-flash-lite"
564
597
  }
565
598
  },
599
+ "gemini-3.1-flash-lite": {
600
+ "extends": "chat-base-3",
601
+ "modelConfig": {
602
+ "model": "gemini-3.1-flash-lite"
603
+ }
604
+ },
605
+ "gemini-3.5-flash": {
606
+ "extends": "chat-base-3",
607
+ "modelConfig": {
608
+ "model": "gemini-3.5-flash"
609
+ }
610
+ },
566
611
  "gemma-4-31b-it": {
567
612
  "extends": "chat-base-3",
568
613
  "modelConfig": {
@@ -587,10 +632,16 @@ their corresponding top-level category object in your `settings.json` file.
587
632
  "model": "gemini-3-flash-preview"
588
633
  }
589
634
  },
635
+ "gemini-3.5-flash-base": {
636
+ "extends": "base",
637
+ "modelConfig": {
638
+ "model": "gemini-3.5-flash"
639
+ }
640
+ },
590
641
  "classifier": {
591
642
  "extends": "base",
592
643
  "modelConfig": {
593
- "model": "gemini-2.5-flash-lite",
644
+ "model": "flash-lite",
594
645
  "generateContentConfig": {
595
646
  "maxOutputTokens": 1024,
596
647
  "thinkingConfig": {
@@ -602,7 +653,7 @@ their corresponding top-level category object in your `settings.json` file.
602
653
  "prompt-completion": {
603
654
  "extends": "base",
604
655
  "modelConfig": {
605
- "model": "gemini-2.5-flash-lite",
656
+ "model": "flash-lite",
606
657
  "generateContentConfig": {
607
658
  "temperature": 0.3,
608
659
  "maxOutputTokens": 16000,
@@ -615,7 +666,7 @@ their corresponding top-level category object in your `settings.json` file.
615
666
  "fast-ack-helper": {
616
667
  "extends": "base",
617
668
  "modelConfig": {
618
- "model": "gemini-2.5-flash-lite",
669
+ "model": "flash-lite",
619
670
  "generateContentConfig": {
620
671
  "temperature": 0.2,
621
672
  "maxOutputTokens": 120,
@@ -628,7 +679,7 @@ their corresponding top-level category object in your `settings.json` file.
628
679
  "edit-corrector": {
629
680
  "extends": "base",
630
681
  "modelConfig": {
631
- "model": "gemini-2.5-flash-lite",
682
+ "model": "flash-lite",
632
683
  "generateContentConfig": {
633
684
  "thinkingConfig": {
634
685
  "thinkingBudget": 0
@@ -639,7 +690,7 @@ their corresponding top-level category object in your `settings.json` file.
639
690
  "summarizer-default": {
640
691
  "extends": "base",
641
692
  "modelConfig": {
642
- "model": "gemini-2.5-flash-lite",
693
+ "model": "flash-lite",
643
694
  "generateContentConfig": {
644
695
  "maxOutputTokens": 2000
645
696
  }
@@ -648,7 +699,7 @@ their corresponding top-level category object in your `settings.json` file.
648
699
  "summarizer-shell": {
649
700
  "extends": "base",
650
701
  "modelConfig": {
651
- "model": "gemini-2.5-flash-lite",
702
+ "model": "flash-lite",
652
703
  "generateContentConfig": {
653
704
  "maxOutputTokens": 2000
654
705
  }
@@ -700,6 +751,19 @@ their corresponding top-level category object in your `settings.json` file.
700
751
  "extends": "gemini-3-flash-base",
701
752
  "modelConfig": {}
702
753
  },
754
+ "context-snapshotter": {
755
+ "extends": "gemini-3-flash-base",
756
+ "modelConfig": {
757
+ "generateContentConfig": {
758
+ "thinkingConfig": {
759
+ "thinkingLevel": "HIGH"
760
+ },
761
+ "temperature": 1,
762
+ "topP": 0.95,
763
+ "topK": 64
764
+ }
765
+ }
766
+ },
703
767
  "chat-compression-3-pro": {
704
768
  "modelConfig": {
705
769
  "model": "gemini-3-pro-preview"
@@ -712,7 +776,7 @@ their corresponding top-level category object in your `settings.json` file.
712
776
  },
713
777
  "chat-compression-3.1-flash-lite": {
714
778
  "modelConfig": {
715
- "model": "gemini-3.1-flash-lite-preview"
779
+ "model": "gemini-3.1-flash-lite"
716
780
  }
717
781
  },
718
782
  "chat-compression-2.5-pro": {
@@ -766,10 +830,10 @@ their corresponding top-level category object in your `settings.json` file.
766
830
 
767
831
  ```json
768
832
  {
769
- "gemini-3.1-flash-lite-preview": {
833
+ "gemini-3.1-flash-lite": {
770
834
  "tier": "flash-lite",
771
835
  "family": "gemini-3",
772
- "isPreview": true,
836
+ "isPreview": false,
773
837
  "isVisible": true,
774
838
  "features": {
775
839
  "thinking": false,
@@ -816,6 +880,16 @@ their corresponding top-level category object in your `settings.json` file.
816
880
  "multimodalToolUse": true
817
881
  }
818
882
  },
883
+ "gemini-3.5-flash": {
884
+ "tier": "flash",
885
+ "family": "gemini-3",
886
+ "isPreview": false,
887
+ "isVisible": true,
888
+ "features": {
889
+ "thinking": false,
890
+ "multimodalToolUse": true
891
+ }
892
+ },
819
893
  "gemini-2.5-pro": {
820
894
  "tier": "pro",
821
895
  "family": "gemini-2.5",
@@ -869,9 +943,10 @@ their corresponding top-level category object in your `settings.json` file.
869
943
  }
870
944
  },
871
945
  "auto": {
946
+ "displayName": "Auto",
872
947
  "tier": "auto",
873
948
  "isPreview": true,
874
- "isVisible": false,
949
+ "isVisible": true,
875
950
  "features": {
876
951
  "thinking": true,
877
952
  "multimodalToolUse": false
@@ -905,26 +980,16 @@ their corresponding top-level category object in your `settings.json` file.
905
980
  }
906
981
  },
907
982
  "auto-gemini-3": {
908
- "displayName": "Auto (Gemini 3)",
909
983
  "tier": "auto",
984
+ "family": "gemini-3",
910
985
  "isPreview": true,
911
- "isVisible": true,
912
- "dialogDescription": "Let Gemini CLI decide the best model for the task: gemini-3-pro, gemini-3-flash",
913
- "features": {
914
- "thinking": true,
915
- "multimodalToolUse": false
916
- }
986
+ "isVisible": false
917
987
  },
918
988
  "auto-gemini-2.5": {
919
- "displayName": "Auto (Gemini 2.5)",
920
989
  "tier": "auto",
990
+ "family": "gemini-2.5",
921
991
  "isPreview": false,
922
- "isVisible": true,
923
- "dialogDescription": "Let Gemini CLI decide the best model for the task: gemini-2.5-pro, gemini-2.5-flash",
924
- "features": {
925
- "thinking": false,
926
- "multimodalToolUse": false
927
- }
992
+ "isVisible": false
928
993
  }
929
994
  }
930
995
  ```
@@ -977,37 +1042,50 @@ their corresponding top-level category object in your `settings.json` file.
977
1042
  "contexts": [
978
1043
  {
979
1044
  "condition": {
980
- "hasAccessToPreview": false
1045
+ "hasAccessToPreview": false,
1046
+ "useGemini3_5Flash": true
1047
+ },
1048
+ "target": "gemini-3.5-flash"
1049
+ },
1050
+ {
1051
+ "condition": {
1052
+ "hasAccessToPreview": false,
1053
+ "useGemini3_5Flash": false
981
1054
  },
982
1055
  "target": "gemini-2.5-flash"
983
1056
  }
984
1057
  ]
985
1058
  },
986
- "gemini-3-pro-preview": {
987
- "default": "gemini-3-pro-preview",
1059
+ "gemini-3.5-flash": {
1060
+ "default": "gemini-3.5-flash",
988
1061
  "contexts": [
989
1062
  {
990
1063
  "condition": {
1064
+ "useGemini3_5Flash": false,
991
1065
  "hasAccessToPreview": false
992
1066
  },
993
- "target": "gemini-2.5-pro"
1067
+ "target": "gemini-2.5-flash"
994
1068
  },
995
1069
  {
996
1070
  "condition": {
997
- "useGemini3_1": true,
998
- "useCustomTools": true
1071
+ "useGemini3_5Flash": false
999
1072
  },
1000
- "target": "gemini-3.1-pro-preview-customtools"
1001
- },
1073
+ "target": "gemini-3-flash-preview"
1074
+ }
1075
+ ]
1076
+ },
1077
+ "gemini-2.5-flash": {
1078
+ "default": "gemini-2.5-flash",
1079
+ "contexts": [
1002
1080
  {
1003
1081
  "condition": {
1004
- "useGemini3_1": true
1082
+ "useGemini3_5Flash": true
1005
1083
  },
1006
- "target": "gemini-3.1-pro-preview"
1084
+ "target": "gemini-3.5-flash"
1007
1085
  }
1008
1086
  ]
1009
1087
  },
1010
- "auto-gemini-3": {
1088
+ "gemini-3-pro-preview": {
1011
1089
  "default": "gemini-3-pro-preview",
1012
1090
  "contexts": [
1013
1091
  {
@@ -1079,23 +1157,18 @@ their corresponding top-level category object in your `settings.json` file.
1079
1157
  }
1080
1158
  ]
1081
1159
  },
1082
- "auto-gemini-2.5": {
1083
- "default": "gemini-2.5-pro"
1160
+ "gemini-3.1-flash-lite": {
1161
+ "default": "gemini-3.1-flash-lite"
1084
1162
  },
1085
- "gemini-3.1-flash-lite-preview": {
1086
- "default": "gemini-3.1-flash-lite-preview",
1163
+ "flash": {
1164
+ "default": "gemini-3-flash-preview",
1087
1165
  "contexts": [
1088
1166
  {
1089
1167
  "condition": {
1090
- "useGemini3_1FlashLite": false
1168
+ "useGemini3_5Flash": true
1091
1169
  },
1092
- "target": "gemini-2.5-flash-lite"
1093
- }
1094
- ]
1095
- },
1096
- "flash": {
1097
- "default": "gemini-3-flash-preview",
1098
- "contexts": [
1170
+ "target": "gemini-3.5-flash"
1171
+ },
1099
1172
  {
1100
1173
  "condition": {
1101
1174
  "hasAccessToPreview": false
@@ -1105,15 +1178,34 @@ their corresponding top-level category object in your `settings.json` file.
1105
1178
  ]
1106
1179
  },
1107
1180
  "flash-lite": {
1108
- "default": "gemini-2.5-flash-lite",
1181
+ "default": "gemini-3.1-flash-lite"
1182
+ },
1183
+ "auto-gemini-3": {
1184
+ "default": "gemini-3-pro-preview",
1109
1185
  "contexts": [
1110
1186
  {
1111
1187
  "condition": {
1112
- "useGemini3_1FlashLite": true
1188
+ "hasAccessToPreview": false
1189
+ },
1190
+ "target": "gemini-2.5-pro"
1191
+ },
1192
+ {
1193
+ "condition": {
1194
+ "useGemini3_1": true,
1195
+ "useCustomTools": true
1196
+ },
1197
+ "target": "gemini-3.1-pro-preview-customtools"
1198
+ },
1199
+ {
1200
+ "condition": {
1201
+ "useGemini3_1": true
1113
1202
  },
1114
- "target": "gemini-3.1-flash-lite-preview"
1203
+ "target": "gemini-3.1-pro-preview"
1115
1204
  }
1116
1205
  ]
1206
+ },
1207
+ "auto-gemini-2.5": {
1208
+ "default": "gemini-2.5-pro"
1117
1209
  }
1118
1210
  }
1119
1211
  ```
@@ -1132,15 +1224,21 @@ their corresponding top-level category object in your `settings.json` file.
1132
1224
  "contexts": [
1133
1225
  {
1134
1226
  "condition": {
1135
- "requestedModels": ["auto-gemini-2.5", "gemini-2.5-pro"]
1227
+ "useGemini3_5Flash": true
1228
+ },
1229
+ "target": "gemini-3.5-flash"
1230
+ },
1231
+ {
1232
+ "condition": {
1233
+ "hasAccessToPreview": false
1136
1234
  },
1137
1235
  "target": "gemini-2.5-flash"
1138
1236
  },
1139
1237
  {
1140
1238
  "condition": {
1141
- "requestedModels": ["auto-gemini-3", "gemini-3-pro-preview"]
1239
+ "requestedModels": ["gemini-2.5-pro", "auto-gemini-2.5"]
1142
1240
  },
1143
- "target": "gemini-3-flash-preview"
1241
+ "target": "gemini-2.5-flash"
1144
1242
  }
1145
1243
  ]
1146
1244
  },
@@ -1149,7 +1247,13 @@ their corresponding top-level category object in your `settings.json` file.
1149
1247
  "contexts": [
1150
1248
  {
1151
1249
  "condition": {
1152
- "requestedModels": ["auto-gemini-2.5", "gemini-2.5-pro"]
1250
+ "hasAccessToPreview": false
1251
+ },
1252
+ "target": "gemini-2.5-pro"
1253
+ },
1254
+ {
1255
+ "condition": {
1256
+ "requestedModels": ["gemini-2.5-pro", "auto-gemini-2.5"]
1153
1257
  },
1154
1258
  "target": "gemini-2.5-pro"
1155
1259
  },
@@ -1320,7 +1424,7 @@ their corresponding top-level category object in your `settings.json` file.
1320
1424
  ],
1321
1425
  "lite": [
1322
1426
  {
1323
- "model": "gemini-2.5-flash-lite",
1427
+ "model": "flash-lite",
1324
1428
  "actions": {
1325
1429
  "terminal": "silent",
1326
1430
  "transient": "silent",
@@ -1795,7 +1899,7 @@ their corresponding top-level category object in your `settings.json` file.
1795
1899
  - **`experimental.voice.stopGracePeriodMs`** (number):
1796
1900
  - **Description:** How long to wait for final transcription after stopping
1797
1901
  recording.
1798
- - **Default:** `1000`
1902
+ - **Default:** `4000`
1799
1903
 
1800
1904
  - **`experimental.adk.agentSessionNoninteractiveEnabled`** (boolean):
1801
1905
  - **Description:** Enable non-interactive agent sessions.
@@ -1808,6 +1912,12 @@ their corresponding top-level category object in your `settings.json` file.
1808
1912
  - **Default:** `false`
1809
1913
  - **Requires restart:** Yes
1810
1914
 
1915
+ - **`experimental.adk.agentSessionSubagentEnabled`** (boolean):
1916
+ - **Description:** Route subagent invocations through the AgentSession
1917
+ protocol instead of legacy executors.
1918
+ - **Default:** `false`
1919
+ - **Requires restart:** Yes
1920
+
1811
1921
  - **`experimental.enableAgents`** (boolean):
1812
1922
  - **Description:** Enable local and remote subagents.
1813
1923
  - **Default:** `true`
@@ -1844,13 +1954,6 @@ their corresponding top-level category object in your `settings.json` file.
1844
1954
  - **Default:** `false`
1845
1955
  - **Requires restart:** Yes
1846
1956
 
1847
- - **`experimental.jitContext`** (boolean):
1848
- - **Description:** Enable Just-In-Time (JIT) context loading. Defaults to
1849
- true; set to false to opt out and load all GEMINI.md files into the system
1850
- instruction up-front.
1851
- - **Default:** `true`
1852
- - **Requires restart:** Yes
1853
-
1854
1957
  - **`experimental.useOSC52Paste`** (boolean):
1855
1958
  - **Description:** Use OSC 52 for pasting. This may be more robust than the
1856
1959
  default system when using remote terminal sessions (if your terminal is
@@ -1913,19 +2016,6 @@ their corresponding top-level category object in your `settings.json` file.
1913
2016
  - **Default:** `"gemma3-1b-gpu-custom"`
1914
2017
  - **Requires restart:** Yes
1915
2018
 
1916
- - **`experimental.memoryV2`** (boolean):
1917
- - **Description:** Disable the built-in save_memory tool and let the main
1918
- agent persist project context by editing markdown files directly with
1919
- edit/write_file. Route facts across four tiers: team-shared conventions go
1920
- to project GEMINI.md files, project-specific personal notes go to the
1921
- per-project private memory folder (MEMORY.md as index + sibling .md files
1922
- for detail), and cross-project personal preferences go to the global
1923
- ~/.gemini/GEMINI.md (the only file under ~/.gemini/ that the agent can edit
1924
- — settings, credentials, etc. remain off-limits). Set to false to fall back
1925
- to the legacy save_memory tool.
1926
- - **Default:** `true`
1927
- - **Requires restart:** Yes
1928
-
1929
2019
  - **`experimental.stressTestProfile`** (boolean):
1930
2020
  - **Description:** Significantly lowers token limits to force early garbage
1931
2021
  collection and distillation for testing purposes.
@@ -1945,6 +2035,11 @@ their corresponding top-level category object in your `settings.json` file.
1945
2035
  - **Default:** `false`
1946
2036
  - **Requires restart:** Yes
1947
2037
 
2038
+ - **`experimental.powerUserProfile`** (boolean):
2039
+ - **Description:** Less cache friendly version of the generalist profile.
2040
+ - **Default:** `false`
2041
+ - **Requires restart:** Yes
2042
+
1948
2043
  - **`experimental.contextManagement`** (boolean):
1949
2044
  - **Description:** Enable logic for context management.
1950
2045
  - **Default:** `false`
@@ -326,6 +326,29 @@ lines and `3w` moves forward three words.
326
326
  Counts are also supported for editing commands. For example, `3dd` deletes three
327
327
  lines and `2cw` changes two words.
328
328
 
329
+ ### Find, replace, yank, and paste in NORMAL mode
330
+
331
+ | Action | Keys |
332
+ | ----------------------------------------- | ----------- |
333
+ | Find next matching character | `f{char}` |
334
+ | Find previous matching character | `F{char}` |
335
+ | Move until before next matching character | `t{char}` |
336
+ | Move until after previous matching char | `T{char}` |
337
+ | Repeat latest character find | `;` |
338
+ | Repeat latest character find in reverse | `,` |
339
+ | Delete character before cursor | `X` |
340
+ | Toggle case under cursor | `~` |
341
+ | Replace character under cursor | `r{char}` |
342
+ | Yank line | `yy` |
343
+ | Yank to end of line | `Y` or `y$` |
344
+ | Yank word / WORD | `yw`, `yW` |
345
+ | Yank to end of word / WORD | `ye`, `yE` |
346
+ | Paste after cursor | `p` |
347
+ | Paste before cursor | `P` |
348
+
349
+ Delete and change operators also compose with character-find motions, so
350
+ commands such as `dfx`, `dtx`, `cFx`, and `cTx` are supported.
351
+
329
352
  ## Limitations
330
353
 
331
354
  - On [Windows Terminal](https://en.wikipedia.org/wiki/Windows_Terminal):
@@ -120,7 +120,6 @@ each tool.
120
120
  | :----------------------------------------------- | :------ | :----------------------------------------------------------------------------------- |
121
121
  | [`activate_skill`](../tools/activate-skill.md) | `Other` | Loads specialized procedural expertise from the `.gemini/skills` directory. |
122
122
  | [`get_internal_docs`](../tools/internal-docs.md) | `Think` | Accesses Gemini CLI's own documentation for accurate answers about its capabilities. |
123
- | [`save_memory`](../tools/memory.md) | `Think` | Persists specific facts and project details to your `GEMINI.md` file. |
124
123
 
125
124
  ### Planning
126
125
 
@@ -173,7 +172,6 @@ representation of each tool's arguments.
173
172
  | `replace` | `file_path`, `old_string`, `new_string`, `instruction`, `allow_multiple` |
174
173
  | `ask_user` | `questions` (array of `question`, `header`, `type`, `options`) |
175
174
  | `write_todos` | `todos` (array of `description`, `status`) |
176
- | `save_memory` | `fact` |
177
175
  | `activate_skill` | `name` |
178
176
  | `get_internal_docs` | `path` |
179
177
  | `enter_plan_mode` | `reason` |
@@ -221,8 +221,10 @@ spawning MCP server processes.
221
221
  #### Automatic redaction
222
222
 
223
223
  By default, the CLI redacts sensitive environment variables from the base
224
- environment (inherited from the host process) to prevent unintended exposure to
225
- third-party MCP servers. This includes:
224
+ environment (inherited from the host process). This prevents the accidental
225
+ leakage of sensitive host environment variables (like AWS keys or GitHub tokens)
226
+ to arbitrary third-party MCP servers that might execute malicious code or log
227
+ your environment. This includes:
226
228
 
227
229
  - Core project keys: `GEMINI_API_KEY`, `GOOGLE_API_KEY`, etc.
228
230
  - Variables matching sensitive patterns: `*TOKEN*`, `*SECRET*`, `*PASSWORD*`,
@@ -232,7 +234,8 @@ third-party MCP servers. This includes:
232
234
  #### Explicit overrides
233
235
 
234
236
  If an environment variable must be passed to an MCP server, you must explicitly
235
- state it in the `env` property of the server configuration in `settings.json`.
237
+ state it in the `env` property of the server configuration in `settings.json`
238
+ (or `mcp_config.json` if configuring standard MCP clients or remote skills).
236
239
  Explicitly defined variables (including those from extensions) are trusted and
237
240
  are **not** subjected to the automatic redaction process.
238
241
 
@@ -247,6 +250,24 @@ specific data with that server.
247
250
  > (for example, `"MY_KEY": "$MY_KEY"`) to securely pull the value from your host
248
251
  > environment at runtime.
249
252
 
253
+ **Example: Passing a GitHub Token securely to the
254
+ [official GitHub MCP server](https://github.com/github/github-mcp-server) via
255
+ `mcp_config.json`**
256
+
257
+ ```json
258
+ {
259
+ "mcpServers": {
260
+ "github": {
261
+ "command": "npx",
262
+ "args": ["-y", "@github/github-mcp-server"],
263
+ "env": {
264
+ "GITHUB_PERSONAL_ACCESS_TOKEN": "$GITHUB_PERSONAL_ACCESS_TOKEN"
265
+ }
266
+ }
267
+ }
268
+ }
269
+ ```
270
+
250
271
  ### OAuth support for remote MCP servers
251
272
 
252
273
  Gemini CLI supports OAuth 2.0 authentication for remote MCP servers using SSE or
@@ -1,25 +1,22 @@
1
- # Memory tool (`save_memory`)
1
+ # Memory files
2
2
 
3
- The `save_memory` tool allows the Gemini agent to persist specific facts, user
4
- preferences, and project details across sessions.
3
+ Gemini CLI persists durable facts, user preferences, and project details by
4
+ editing Markdown memory files directly.
5
5
 
6
6
  ## Technical reference
7
7
 
8
- This tool appends information to the `## Gemini Added Memories` section of your
9
- global `GEMINI.md` file (typically located at `~/.gemini/GEMINI.md`).
10
-
11
- ### Arguments
12
-
13
- - `fact` (string, required): A clear, self-contained statement in natural
14
- language.
8
+ The agent routes memories to the appropriate Markdown file: shared project
9
+ instructions go in repository `GEMINI.md` files, private project notes go in the
10
+ per-project private memory folder, and cross-project personal preferences go in
11
+ the global `~/.gemini/GEMINI.md` file.
15
12
 
16
13
  ## Technical behavior
17
14
 
18
- - **Storage:** Appends to the global context file in the user's home directory.
15
+ - **Storage:** Edits Markdown files with `write_file` or `replace`.
19
16
  - **Loading:** The stored facts are automatically included in the hierarchical
20
17
  context system for all future sessions.
21
- - **Format:** Saves data as a bulleted list item within a dedicated Markdown
22
- section.
18
+ - **Format:** Keeps durable instructions concise and avoids duplicating the same
19
+ fact across multiple memory tiers.
23
20
 
24
21
  ## Use cases
25
22
 
@@ -0,0 +1,6 @@
1
+ prompt = """
2
+ Please summarize the findings for the pattern `{{args}}`.
3
+
4
+ Search Results:
5
+ !{grep -r {{args}} .}
6
+ """