@codeflyai/codefly 0.24.1 → 0.24.4

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 (48) hide show
  1. package/bundle/builtin/skill-creator/SKILL.md +382 -0
  2. package/bundle/builtin/skill-creator/scripts/init_skill.cjs +235 -0
  3. package/bundle/builtin/skill-creator/scripts/package_skill.cjs +102 -0
  4. package/bundle/builtin/skill-creator/scripts/validate_skill.cjs +127 -0
  5. package/bundle/codefly.js +275926 -275321
  6. package/bundle/docs/architecture.md +3 -3
  7. package/bundle/docs/assets/monitoring-dashboard-logs.png +0 -0
  8. package/bundle/docs/assets/monitoring-dashboard-metrics.png +0 -0
  9. package/bundle/docs/assets/monitoring-dashboard-overview.png +0 -0
  10. package/bundle/docs/changelogs/index.md +134 -0
  11. package/bundle/docs/changelogs/latest.md +355 -210
  12. package/bundle/docs/changelogs/preview.md +318 -115
  13. package/bundle/docs/cli/commands.md +21 -0
  14. package/bundle/docs/cli/custom-commands.md +9 -9
  15. package/bundle/docs/cli/index.md +6 -2
  16. package/bundle/docs/cli/keyboard-shortcuts.md +61 -78
  17. package/bundle/docs/cli/model-routing.md +7 -2
  18. package/bundle/docs/cli/model.md +1 -1
  19. package/bundle/docs/cli/openspec.md +164 -0
  20. package/bundle/docs/cli/sandbox.md +1 -1
  21. package/bundle/docs/cli/settings.md +80 -60
  22. package/bundle/docs/cli/skills.md +188 -0
  23. package/bundle/docs/cli/system-prompt.md +32 -0
  24. package/bundle/docs/cli/telemetry.md +38 -3
  25. package/bundle/docs/cli/themes.md +0 -2
  26. package/bundle/docs/cli/tutorials/skills-getting-started.md +124 -0
  27. package/bundle/docs/cli/tutorials.md +4 -0
  28. package/bundle/docs/core/index.md +4 -0
  29. package/bundle/docs/core/memport.md +2 -0
  30. package/bundle/docs/core/policy-engine.md +3 -2
  31. package/bundle/docs/extensions/getting-started-extensions.md +39 -2
  32. package/bundle/docs/get-started/configuration.md +130 -74
  33. package/bundle/docs/get-started/gemini-3.md +2 -17
  34. package/bundle/docs/hooks/reference.md +245 -116
  35. package/bundle/docs/index.md +2 -0
  36. package/bundle/docs/local-development.md +1 -1
  37. package/bundle/docs/releases.md +1 -1
  38. package/bundle/docs/sidebar.json +5 -5
  39. package/bundle/docs/tools/index.md +3 -0
  40. package/bundle/docs/tools/mcp-server.md +26 -2
  41. package/bundle/docs/tools/shell.md +1 -1
  42. package/bundle/docs/troubleshooting.md +23 -5
  43. package/bundle/policies/agent.toml +1 -1
  44. package/bundle/policies/plan.toml +70 -0
  45. package/bundle/policies/read-only.toml +0 -5
  46. package/bundle/policies/yolo.toml +1 -0
  47. package/package.json +10 -5
  48. package/bundle/docs/get-started/deployment.md +0 -143
@@ -1,6 +1,6 @@
1
- # Preview release: Release v0.22.0-preview.0
1
+ # Preview release: Release v0.26.0-preview.0
2
2
 
3
- Released: December 16, 2025
3
+ Released: January 21, 2026
4
4
 
5
5
  Our preview release includes the latest, new, and experimental features. This
6
6
  release may not be as stable as our [latest weekly release](latest.md).
@@ -11,119 +11,322 @@ To install the preview release:
11
11
  npm install -g @google/gemini-cli@preview
12
12
  ```
13
13
 
14
+ ## Highlights
15
+
16
+ - **Skills and Agents:** Improvements to the `activate_skill` tool and skill
17
+ management. Experimental Agent Skills support.
18
+ - **UI/UX:** Addition of a Rewind Confirmation dialog and Viewer component.
19
+ - **Extensions:** Experimental setting for extension configuration.
20
+ - **Bug Fixes and Stability:** PDF token estimation fix and improvements to
21
+ scheduled issue triage.
22
+
14
23
  ## What's Changed
15
24
 
16
- - feat(ide): fallback to GEMINI_CLI_IDE_AUTH_TOKEN env var by @skeshive in
17
- https://github.com/google-gemini/gemini-cli/pull/14843
18
- - feat: display quota stats for unused models in /stats by @sehoon38 in
19
- https://github.com/google-gemini/gemini-cli/pull/14764
20
- - feat: ensure codebase investigator uses preview model when main agent does by
21
- @abhipatel12 in https://github.com/google-gemini/gemini-cli/pull/14412
22
- - chore: add closing reason to stale bug workflow by @galz10 in
23
- https://github.com/google-gemini/gemini-cli/pull/14861
24
- - Send the model and CLI version with the user agent by @gundermanc in
25
- https://github.com/google-gemini/gemini-cli/pull/14865
26
- - refactor(sessions): move session summary generation to startup by
27
- @jackwotherspoon in https://github.com/google-gemini/gemini-cli/pull/14691
28
- - Limit search depth in path corrector by @scidomino in
29
- https://github.com/google-gemini/gemini-cli/pull/14869
30
- - Fix: Correct typo in code comment by @kuishou68 in
31
- https://github.com/google-gemini/gemini-cli/pull/14671
32
- - feat(core): Plumbing for late resolution of model configs. by @joshualitt in
33
- https://github.com/google-gemini/gemini-cli/pull/14597
34
- - feat: attempt more error parsing by @adamfweidman in
35
- https://github.com/google-gemini/gemini-cli/pull/14899
36
- - Add missing await. by @gundermanc in
37
- https://github.com/google-gemini/gemini-cli/pull/14910
38
- - feat(core): Add support for transcript_path in hooks for git-ai/Gemini
39
- extension by @svarlamov in
40
- https://github.com/google-gemini/gemini-cli/pull/14663
41
- - refactor: implement DelegateToAgentTool with discriminated union by
42
- @abhipatel12 in https://github.com/google-gemini/gemini-cli/pull/14769
43
- - feat: reset availabilityService on /auth by @adamfweidman in
44
- https://github.com/google-gemini/gemini-cli/pull/14911
45
- - chore/release: bump version to 0.21.0-nightly.20251211.8c83e1ea9 by
46
- @gemini-cli-robot in https://github.com/google-gemini/gemini-cli/pull/14924
47
- - Fix: Correctly detect MCP tool errors by @kevin-ramdass in
48
- https://github.com/google-gemini/gemini-cli/pull/14937
49
- - increase labeler timeout by @scidomino in
50
- https://github.com/google-gemini/gemini-cli/pull/14922
51
- - tool(cli): tweak the frontend tool to be aware of more core files from the cli
52
- by @jacob314 in https://github.com/google-gemini/gemini-cli/pull/14962
53
- - feat(cli): polish cached token stats and simplify stats display when quota is
54
- present. by @jacob314 in
55
- https://github.com/google-gemini/gemini-cli/pull/14961
56
- - feat(settings-validation): add validation for settings schema by @lifefloating
57
- in https://github.com/google-gemini/gemini-cli/pull/12929
58
- - fix(ide): Update IDE extension to write auth token in env var by @skeshive in
59
- https://github.com/google-gemini/gemini-cli/pull/14999
60
- - Revert "chore(deps): bump express from 5.1.0 to 5.2.0" by @skeshive in
61
- https://github.com/google-gemini/gemini-cli/pull/14998
62
- - feat(a2a): Introduce /init command for a2a server by @cocosheng-g in
63
- https://github.com/google-gemini/gemini-cli/pull/13419
64
- - feat: support multi-file drag and drop of images by @jackwotherspoon in
65
- https://github.com/google-gemini/gemini-cli/pull/14832
66
- - fix(policy): allow codebase_investigator by default in read-only policy by
67
- @abhipatel12 in https://github.com/google-gemini/gemini-cli/pull/15000
68
- - refactor(ide ext): Update port file name + switch to 1-based index for
69
- characters + remove truncation text by @skeshive in
70
- https://github.com/google-gemini/gemini-cli/pull/10501
71
- - fix(vscode-ide-companion): correct license generation for workspace
72
- dependencies by @skeshive in
73
- https://github.com/google-gemini/gemini-cli/pull/15004
74
- - fix: temp fix for subagent invocation until subagent delegation is merged to
75
- stable by @abhipatel12 in
76
- https://github.com/google-gemini/gemini-cli/pull/15007
77
- - test: update ide detection tests to make them more robust when run in an ide
78
- by @kevin-ramdass in https://github.com/google-gemini/gemini-cli/pull/15008
79
- - Remove flex from stats display. See snapshots for diffs. by @jacob314 in
80
- https://github.com/google-gemini/gemini-cli/pull/14983
81
- - Add license field into package.json by @jb-perez in
82
- https://github.com/google-gemini/gemini-cli/pull/14473
83
- - feat: Persistent "Always Allow" policies with granular shell & MCP support by
84
- @allenhutchison in https://github.com/google-gemini/gemini-cli/pull/14737
85
- - chore/release: bump version to 0.21.0-nightly.20251212.54de67536 by
86
- @gemini-cli-robot in https://github.com/google-gemini/gemini-cli/pull/14969
87
- - fix(core): commandPrefix word boundary and compound command safety by
88
- @allenhutchison in https://github.com/google-gemini/gemini-cli/pull/15006
89
- - chore(docs): add 'Maintainers only' label info to CONTRIBUTING.md by @jacob314
90
- in https://github.com/google-gemini/gemini-cli/pull/14914
91
- - Refresh hooks when refreshing extensions. by @scidomino in
92
- https://github.com/google-gemini/gemini-cli/pull/14918
93
- - Add clarity to error messages by @gsehgal in
94
- https://github.com/google-gemini/gemini-cli/pull/14879
95
- - chore : remove a redundant tip by @JayadityaGit in
96
- https://github.com/google-gemini/gemini-cli/pull/14947
97
- - chore/release: bump version to 0.21.0-nightly.20251213.977248e09 by
98
- @gemini-cli-robot in https://github.com/google-gemini/gemini-cli/pull/15029
99
- - Disallow redundant typecasts. by @gundermanc in
100
- https://github.com/google-gemini/gemini-cli/pull/15030
101
- - fix(auth): prioritize GEMINI_API_KEY env var and skip unnecessary key… by
102
- @galz10 in https://github.com/google-gemini/gemini-cli/pull/14745
103
- - fix: use zod for safety check result validation by @allenhutchison in
104
- https://github.com/google-gemini/gemini-cli/pull/15026
105
- - update(telemetry): add hashed_extension_name to field to extension events by
106
- @kiranani in https://github.com/google-gemini/gemini-cli/pull/15025
107
- - fix: similar to policy-engine, throw error in case of requiring tool execution
108
- confirmation for non-interactive mode by @MayV in
109
- https://github.com/google-gemini/gemini-cli/pull/14702
110
- - Clean up processes in integration tests by @scidomino in
111
- https://github.com/google-gemini/gemini-cli/pull/15102
112
- - docs: update policy engine getting started and defaults by @NTaylorMullen in
113
- https://github.com/google-gemini/gemini-cli/pull/15105
114
- - Fix tool output fragmentation by encapsulating content in functionResponse by
115
- @abhipatel12 in https://github.com/google-gemini/gemini-cli/pull/13082
116
- - Simplify method signature. by @scidomino in
117
- https://github.com/google-gemini/gemini-cli/pull/15114
118
- - Show raw input token counts in json output. by @jacob314 in
119
- https://github.com/google-gemini/gemini-cli/pull/15021
120
- - fix: Mark A2A requests as interactive by @MayV in
121
- https://github.com/google-gemini/gemini-cli/pull/15108
122
- - use previewFeatures to determine which pro model to use for A2A by @sehoon38
123
- in https://github.com/google-gemini/gemini-cli/pull/15131
124
- - refactor(cli): fix settings merging so that settings using the new json format
125
- take priority over ones using the old format by @jacob314 in
126
- https://github.com/google-gemini/gemini-cli/pull/15116
25
+ - fix: PDF token estimation
26
+ ([#16494](https://github.com/google-gemini/gemini-cli/pull/16494)) by
27
+ @korade-krushna in
28
+ [#16527](https://github.com/google-gemini/gemini-cli/pull/16527)
29
+ - chore(release): bump version to 0.26.0-nightly.20260114.bb6c57414 by
30
+ @gemini-cli-robot in
31
+ [#16604](https://github.com/google-gemini/gemini-cli/pull/16604)
32
+ - docs: clarify F12 to open debug console by @jackwotherspoon in
33
+ [#16570](https://github.com/google-gemini/gemini-cli/pull/16570)
34
+ - docs: Remove .md extension from internal links in architecture.md by
35
+ @medic-code in
36
+ [#12899](https://github.com/google-gemini/gemini-cli/pull/12899)
37
+ - Add an experimental setting for extension config by @chrstnb in
38
+ [#16506](https://github.com/google-gemini/gemini-cli/pull/16506)
39
+ - feat: add Rewind Confirmation dialog and Rewind Viewer component by @Adib234
40
+ in [#15717](https://github.com/google-gemini/gemini-cli/pull/15717)
41
+ - fix(a2a): Don't throw errors for GeminiEventType Retry and InvalidStream. by
42
+ @ehedlund in [#16541](https://github.com/google-gemini/gemini-cli/pull/16541)
43
+ - prefactor: add rootCommands as array so it can be used for policy parsing by
44
+ @abhipatel12 in
45
+ [#16640](https://github.com/google-gemini/gemini-cli/pull/16640)
46
+ - remove unnecessary \x7f key bindings by @scidomino in
47
+ [#16646](https://github.com/google-gemini/gemini-cli/pull/16646)
48
+ - docs(skills): use body-file in pr-creator skill for better reliability by
49
+ @abhipatel12 in
50
+ [#16642](https://github.com/google-gemini/gemini-cli/pull/16642)
51
+ - chore(automation): recursive labeling for workstream descendants by @bdmorgan
52
+ in [#16609](https://github.com/google-gemini/gemini-cli/pull/16609)
53
+ - feat: introduce 'skill-creator' built-in skill and CJS management tools by
54
+ @NTaylorMullen in
55
+ [#16394](https://github.com/google-gemini/gemini-cli/pull/16394)
56
+ - chore(automation): remove automated PR size and complexity labeler by
57
+ @bdmorgan in [#16648](https://github.com/google-gemini/gemini-cli/pull/16648)
58
+ - refactor(skills): replace 'project' with 'workspace' scope by @NTaylorMullen
59
+ in [#16380](https://github.com/google-gemini/gemini-cli/pull/16380)
60
+ - Docs: Update release notes for 1/13/2026 by @jkcinouye in
61
+ [#16583](https://github.com/google-gemini/gemini-cli/pull/16583)
62
+ - Simplify paste handling by @scidomino in
63
+ [#16654](https://github.com/google-gemini/gemini-cli/pull/16654)
64
+ - chore(automation): improve scheduled issue triage discovery and throughput by
65
+ @bdmorgan in [#16652](https://github.com/google-gemini/gemini-cli/pull/16652)
66
+ - fix(acp): run exit cleanup when stdin closes by @codefromthecrypt in
67
+ [#14953](https://github.com/google-gemini/gemini-cli/pull/14953)
68
+ - feat(scheduler): add types needed for event driven scheduler by @abhipatel12
69
+ in [#16641](https://github.com/google-gemini/gemini-cli/pull/16641)
70
+ - Remove unused rewind key binding by @scidomino in
71
+ [#16659](https://github.com/google-gemini/gemini-cli/pull/16659)
72
+ - Remove sequence binding by @scidomino in
73
+ [#16664](https://github.com/google-gemini/gemini-cli/pull/16664)
74
+ - feat(cli): undeprecate the --prompt flag by @alexaustin007 in
75
+ [#13981](https://github.com/google-gemini/gemini-cli/pull/13981)
76
+ - chore: update dependabot configuration by @cosmopax in
77
+ [#13507](https://github.com/google-gemini/gemini-cli/pull/13507)
78
+ - feat(config): add 'auto' alias for default model selection by @sehoon38 in
79
+ [#16661](https://github.com/google-gemini/gemini-cli/pull/16661)
80
+ - Enable & disable agents by @sehoon38 in
81
+ [#16225](https://github.com/google-gemini/gemini-cli/pull/16225)
82
+ - cleanup: Improve keybindings by @scidomino in
83
+ [#16672](https://github.com/google-gemini/gemini-cli/pull/16672)
84
+ - Add timeout for shell-utils to prevent hangs. by @jacob314 in
85
+ [#16667](https://github.com/google-gemini/gemini-cli/pull/16667)
86
+ - feat(plan): add experimental plan flag by @jerop in
87
+ [#16650](https://github.com/google-gemini/gemini-cli/pull/16650)
88
+ - feat(cli): add security consent prompts for skill installation by
89
+ @NTaylorMullen in
90
+ [#16549](https://github.com/google-gemini/gemini-cli/pull/16549)
91
+ - fix: replace 3 consecutive periods with ellipsis character by @Vist233 in
92
+ [#16587](https://github.com/google-gemini/gemini-cli/pull/16587)
93
+ - chore(automation): ensure status/need-triage is applied and never cleared
94
+ automatically by @bdmorgan in
95
+ [#16657](https://github.com/google-gemini/gemini-cli/pull/16657)
96
+ - fix: Handle colons in skill description frontmatter by @maru0804 in
97
+ [#16345](https://github.com/google-gemini/gemini-cli/pull/16345)
98
+ - refactor(core): harden skill frontmatter parsing by @NTaylorMullen in
99
+ [#16705](https://github.com/google-gemini/gemini-cli/pull/16705)
100
+ - feat(skills): add conflict detection and warnings for skill overrides by
101
+ @NTaylorMullen in
102
+ [#16709](https://github.com/google-gemini/gemini-cli/pull/16709)
103
+ - feat(scheduler): add SchedulerStateManager for reactive tool state by
104
+ @abhipatel12 in
105
+ [#16651](https://github.com/google-gemini/gemini-cli/pull/16651)
106
+ - chore(automation): enforce 'help wanted' label permissions and update
107
+ guidelines by @bdmorgan in
108
+ [#16707](https://github.com/google-gemini/gemini-cli/pull/16707)
109
+ - fix(core): resolve circular dependency via tsconfig paths by @sehoon38 in
110
+ [#16730](https://github.com/google-gemini/gemini-cli/pull/16730)
111
+ - chore/release: bump version to 0.26.0-nightly.20260115.6cb3ae4e0 by
112
+ @gemini-cli-robot in
113
+ [#16738](https://github.com/google-gemini/gemini-cli/pull/16738)
114
+ - fix(automation): correct status/need-issue label matching wildcard by
115
+ @bdmorgan in [#16727](https://github.com/google-gemini/gemini-cli/pull/16727)
116
+ - fix(automation): prevent label-enforcer loop by ignoring all bots by @bdmorgan
117
+ in [#16746](https://github.com/google-gemini/gemini-cli/pull/16746)
118
+ - Add links to supported locations and minor fixes by @g-samroberts in
119
+ [#16476](https://github.com/google-gemini/gemini-cli/pull/16476)
120
+ - feat(policy): add source tracking to policy rules by @allenhutchison in
121
+ [#16670](https://github.com/google-gemini/gemini-cli/pull/16670)
122
+ - feat(automation): enforce '🔒 maintainer only' and fix bot loop by @bdmorgan
123
+ in [#16751](https://github.com/google-gemini/gemini-cli/pull/16751)
124
+ - Make merged settings non-nullable and fix all lints related to that. by
125
+ @jacob314 in [#16647](https://github.com/google-gemini/gemini-cli/pull/16647)
126
+ - fix(core): prevent ModelInfo event emission on aborted signal by @sehoon38 in
127
+ [#16752](https://github.com/google-gemini/gemini-cli/pull/16752)
128
+ - Replace relative paths to fix website build by @chrstnb in
129
+ [#16755](https://github.com/google-gemini/gemini-cli/pull/16755)
130
+ - Restricting to localhost by @cocosheng-g in
131
+ [#16548](https://github.com/google-gemini/gemini-cli/pull/16548)
132
+ - fix(cli): add explicit dependency on color-convert by @sehoon38 in
133
+ [#16757](https://github.com/google-gemini/gemini-cli/pull/16757)
134
+ - fix(automation): robust label enforcement with permission checks by @bdmorgan
135
+ in [#16762](https://github.com/google-gemini/gemini-cli/pull/16762)
136
+ - fix(cli): prevent OOM crash by limiting file search traversal and adding
137
+ timeout by @galz10 in
138
+ [#16696](https://github.com/google-gemini/gemini-cli/pull/16696)
139
+ - fix(cli): safely handle /dev/tty access on macOS by @korade-krushna in
140
+ [#16531](https://github.com/google-gemini/gemini-cli/pull/16531)
141
+ - docs: clarify workspace test execution in GEMINI.md by @mattKorwel in
142
+ [#16764](https://github.com/google-gemini/gemini-cli/pull/16764)
143
+ - Add support for running available commands prior to MCP servers loading by
144
+ @Adib234 in [#15596](https://github.com/google-gemini/gemini-cli/pull/15596)
145
+ - feat(plan): add experimental 'plan' approval mode by @jerop in
146
+ [#16753](https://github.com/google-gemini/gemini-cli/pull/16753)
147
+ - feat(scheduler): add functional awaitConfirmation utility by @abhipatel12 in
148
+ [#16721](https://github.com/google-gemini/gemini-cli/pull/16721)
149
+ - fix(infra): update maintainer rollup label to 'workstream-rollup' by @bdmorgan
150
+ in [#16809](https://github.com/google-gemini/gemini-cli/pull/16809)
151
+ - fix(infra): use GraphQL to detect direct parents in rollup workflow by
152
+ @bdmorgan in [#16811](https://github.com/google-gemini/gemini-cli/pull/16811)
153
+ - chore(workflows): rename label-workstream-rollup workflow by @bdmorgan in
154
+ [#16818](https://github.com/google-gemini/gemini-cli/pull/16818)
155
+ - skip simple-mcp-server.test.ts by @scidomino in
156
+ [#16842](https://github.com/google-gemini/gemini-cli/pull/16842)
157
+ - Steer outer agent to use expert subagents when present by @gundermanc in
158
+ [#16763](https://github.com/google-gemini/gemini-cli/pull/16763)
159
+ - Fix race condition by awaiting scheduleToolCalls by @chrstnb in
160
+ [#16759](https://github.com/google-gemini/gemini-cli/pull/16759)
161
+ - cleanup: Organize key bindings by @scidomino in
162
+ [#16798](https://github.com/google-gemini/gemini-cli/pull/16798)
163
+ - feat(core): Add generalist agent. by @joshualitt in
164
+ [#16638](https://github.com/google-gemini/gemini-cli/pull/16638)
165
+ - perf(ui): optimize text buffer and highlighting for large inputs by
166
+ @NTaylorMullen in
167
+ [#16782](https://github.com/google-gemini/gemini-cli/pull/16782)
168
+ - fix(core): fix PTY descriptor shell leak by @galz10 in
169
+ [#16773](https://github.com/google-gemini/gemini-cli/pull/16773)
170
+ - feat(plan): enforce strict read-only policy and halt execution on violation by
171
+ @jerop in [#16849](https://github.com/google-gemini/gemini-cli/pull/16849)
172
+ - remove need-triage label from bug_report template by @sehoon38 in
173
+ [#16864](https://github.com/google-gemini/gemini-cli/pull/16864)
174
+ - fix(core): truncate large telemetry log entries by @sehoon38 in
175
+ [#16769](https://github.com/google-gemini/gemini-cli/pull/16769)
176
+ - docs(extensions): add Agent Skills support and mark feature as experimental by
177
+ @NTaylorMullen in
178
+ [#16859](https://github.com/google-gemini/gemini-cli/pull/16859)
179
+ - fix(core): surface warnings for invalid hook event names in configuration
180
+ ([#16788](https://github.com/google-gemini/gemini-cli/pull/16788)) by
181
+ @sehoon38 in [#16873](https://github.com/google-gemini/gemini-cli/pull/16873)
182
+ - feat(plan): remove read_many_files from approval mode policies by @jerop in
183
+ [#16876](https://github.com/google-gemini/gemini-cli/pull/16876)
184
+ - feat(admin): implement admin controls polling and restart prompt by @skeshive
185
+ in [#16627](https://github.com/google-gemini/gemini-cli/pull/16627)
186
+ - Remove LRUCache class migrating to mnemoist by @jacob314 in
187
+ [#16872](https://github.com/google-gemini/gemini-cli/pull/16872)
188
+ - feat(settings): rename negative settings to positive naming (disable* ->
189
+ enable*) by @afarber in
190
+ [#14142](https://github.com/google-gemini/gemini-cli/pull/14142)
191
+ - refactor(cli): unify shell confirmation dialogs by @NTaylorMullen in
192
+ [#16828](https://github.com/google-gemini/gemini-cli/pull/16828)
193
+ - feat(agent): enable agent skills by default by @NTaylorMullen in
194
+ [#16736](https://github.com/google-gemini/gemini-cli/pull/16736)
195
+ - refactor(core): foundational truncation refactoring and token estimation
196
+ optimization by @NTaylorMullen in
197
+ [#16824](https://github.com/google-gemini/gemini-cli/pull/16824)
198
+ - fix(hooks): enable /hooks disable to reliably stop single hooks by
199
+ @abhipatel12 in
200
+ [#16804](https://github.com/google-gemini/gemini-cli/pull/16804)
201
+ - Don't commit unless user asks us to. by @gundermanc in
202
+ [#16902](https://github.com/google-gemini/gemini-cli/pull/16902)
203
+ - chore: remove a2a-adapter and bump @a2a-js/sdk to 0.3.8 by @adamfweidman in
204
+ [#16800](https://github.com/google-gemini/gemini-cli/pull/16800)
205
+ - fix: Show experiment values in settings UI for compressionThreshold by
206
+ @ishaanxgupta in
207
+ [#16267](https://github.com/google-gemini/gemini-cli/pull/16267)
208
+ - feat(cli): replace relative keyboard shortcuts link with web URL by
209
+ @imaliabbas in
210
+ [#16479](https://github.com/google-gemini/gemini-cli/pull/16479)
211
+ - fix(core): resolve PKCE length issue and stabilize OAuth redirect port by
212
+ @sehoon38 in [#16815](https://github.com/google-gemini/gemini-cli/pull/16815)
213
+ - Delete rewind documentation for now by @Adib234 in
214
+ [#16932](https://github.com/google-gemini/gemini-cli/pull/16932)
215
+ - Stabilize skill-creator CI and package format by @NTaylorMullen in
216
+ [#17001](https://github.com/google-gemini/gemini-cli/pull/17001)
217
+ - Stabilize the git evals by @gundermanc in
218
+ [#16989](https://github.com/google-gemini/gemini-cli/pull/16989)
219
+ - fix(core): attempt compression before context overflow check by @NTaylorMullen
220
+ in [#16914](https://github.com/google-gemini/gemini-cli/pull/16914)
221
+ - Fix inverted logic. by @gundermanc in
222
+ [#17007](https://github.com/google-gemini/gemini-cli/pull/17007)
223
+ - chore(scripts): add duplicate issue closer script and fix lint errors by
224
+ @bdmorgan in [#16997](https://github.com/google-gemini/gemini-cli/pull/16997)
225
+ - docs: update README and config guide to reference Gemini 3 by @JayadityaGit in
226
+ [#15806](https://github.com/google-gemini/gemini-cli/pull/15806)
227
+ - fix(cli): correct Homebrew installation detection by @kij in
228
+ [#14727](https://github.com/google-gemini/gemini-cli/pull/14727)
229
+ - Demote git evals to nightly run. by @gundermanc in
230
+ [#17030](https://github.com/google-gemini/gemini-cli/pull/17030)
231
+ - fix(cli): use OSC-52 clipboard copy in Windows Terminal by @Thomas-Shephard in
232
+ [#16920](https://github.com/google-gemini/gemini-cli/pull/16920)
233
+ - Fix: Process all parts in response chunks when thought is first by @pyrytakala
234
+ in [#13539](https://github.com/google-gemini/gemini-cli/pull/13539)
235
+ - fix(automation): fix jq quoting error in pr-triage.sh by @Kimsoo0119 in
236
+ [#16958](https://github.com/google-gemini/gemini-cli/pull/16958)
237
+ - refactor(core): decouple scheduler into orchestration, policy, and
238
+ confirmation by @abhipatel12 in
239
+ [#16895](https://github.com/google-gemini/gemini-cli/pull/16895)
240
+ - feat: add /introspect slash command by @NTaylorMullen in
241
+ [#17048](https://github.com/google-gemini/gemini-cli/pull/17048)
242
+ - refactor(cli): centralize tool mapping and decouple legacy scheduler by
243
+ @abhipatel12 in
244
+ [#17044](https://github.com/google-gemini/gemini-cli/pull/17044)
245
+ - fix(ui): ensure rationale renders before tool calls by @NTaylorMullen in
246
+ [#17043](https://github.com/google-gemini/gemini-cli/pull/17043)
247
+ - fix(workflows): use author_association for maintainer check by @bdmorgan in
248
+ [#17060](https://github.com/google-gemini/gemini-cli/pull/17060)
249
+ - fix return type of fireSessionStartEvent to defaultHookOutput by @ved015 in
250
+ [#16833](https://github.com/google-gemini/gemini-cli/pull/16833)
251
+ - feat(cli): add experiment gate for event-driven scheduler by @abhipatel12 in
252
+ [#17055](https://github.com/google-gemini/gemini-cli/pull/17055)
253
+ - feat(core): improve shell redirection transparency and security by
254
+ @NTaylorMullen in
255
+ [#16486](https://github.com/google-gemini/gemini-cli/pull/16486)
256
+ - fix(core): deduplicate ModelInfo emission in GeminiClient by @NTaylorMullen in
257
+ [#17075](https://github.com/google-gemini/gemini-cli/pull/17075)
258
+ - docs(themes): remove unsupported DiffModified color key by @jw409 in
259
+ [#17073](https://github.com/google-gemini/gemini-cli/pull/17073)
260
+ - fix: update currentSequenceModel when modelChanged by @adamfweidman in
261
+ [#17051](https://github.com/google-gemini/gemini-cli/pull/17051)
262
+ - feat(core): enhanced anchored iterative context compression with
263
+ self-verification by @rmedranollamas in
264
+ [#15710](https://github.com/google-gemini/gemini-cli/pull/15710)
265
+ - Fix mcp instructions by @chrstnb in
266
+ [#16439](https://github.com/google-gemini/gemini-cli/pull/16439)
267
+ - [A2A] Disable checkpointing if git is not installed by @cocosheng-g in
268
+ [#16896](https://github.com/google-gemini/gemini-cli/pull/16896)
269
+ - feat(admin): set admin.skills.enabled based on advancedFeaturesEnabled setting
270
+ by @skeshive in
271
+ [#17095](https://github.com/google-gemini/gemini-cli/pull/17095)
272
+ - Test coverage for hook exit code cases by @gundermanc in
273
+ [#17041](https://github.com/google-gemini/gemini-cli/pull/17041)
274
+ - Revert "Revert "Update extension examples"" by @chrstnb in
275
+ [#16445](https://github.com/google-gemini/gemini-cli/pull/16445)
276
+ - fix(core): Provide compact, actionable errors for agent delegation failures by
277
+ @SandyTao520 in
278
+ [#16493](https://github.com/google-gemini/gemini-cli/pull/16493)
279
+ - fix: migrate BeforeModel and AfterModel hooks to HookSystem by @ved015 in
280
+ [#16599](https://github.com/google-gemini/gemini-cli/pull/16599)
281
+ - feat(admin): apply admin settings to gemini skills/mcp/extensions commands by
282
+ @skeshive in [#17102](https://github.com/google-gemini/gemini-cli/pull/17102)
283
+ - fix(core): update telemetry token count after session resume by @psinha40898
284
+ in [#15491](https://github.com/google-gemini/gemini-cli/pull/15491)
285
+ - Demote the subagent test to nightly by @gundermanc in
286
+ [#17105](https://github.com/google-gemini/gemini-cli/pull/17105)
287
+ - feat(plan): telemetry to track adoption and usage of plan mode by @Adib234 in
288
+ [#16863](https://github.com/google-gemini/gemini-cli/pull/16863)
289
+ - feat: Add flash lite utility fallback chain by @adamfweidman in
290
+ [#17056](https://github.com/google-gemini/gemini-cli/pull/17056)
291
+ - Fixes Windows crash: "Cannot resize a pty that has already exited" by @dzammit
292
+ in [#15757](https://github.com/google-gemini/gemini-cli/pull/15757)
293
+ - feat(core): Add initial eval for generalist agent. by @joshualitt in
294
+ [#16856](https://github.com/google-gemini/gemini-cli/pull/16856)
295
+ - feat(core): unify agent enabled and disabled flags by @SandyTao520 in
296
+ [#17127](https://github.com/google-gemini/gemini-cli/pull/17127)
297
+ - fix(core): resolve auto model in default strategy by @sehoon38 in
298
+ [#17116](https://github.com/google-gemini/gemini-cli/pull/17116)
299
+ - docs: update project context and pr-creator workflow by @NTaylorMullen in
300
+ [#17119](https://github.com/google-gemini/gemini-cli/pull/17119)
301
+ - fix(cli): send gemini-cli version as mcp client version by @dsp in
302
+ [#13407](https://github.com/google-gemini/gemini-cli/pull/13407)
303
+ - fix(cli): resolve Ctrl+Enter and Ctrl+J newline issues by @imadraude in
304
+ [#17021](https://github.com/google-gemini/gemini-cli/pull/17021)
305
+ - Remove missing sidebar item by @chrstnb in
306
+ [#17145](https://github.com/google-gemini/gemini-cli/pull/17145)
307
+ - feat(core): Ensure all properties in hooks object are event names. by
308
+ @joshualitt in
309
+ [#16870](https://github.com/google-gemini/gemini-cli/pull/16870)
310
+ - fix(cli): fix newline support broken in previous PR by @scidomino in
311
+ [#17159](https://github.com/google-gemini/gemini-cli/pull/17159)
312
+ - Add interactive ValidationDialog for handling 403 VALIDATION_REQUIRED errors.
313
+ by @gsquared94 in
314
+ [#16231](https://github.com/google-gemini/gemini-cli/pull/16231)
315
+ - Add Esc-Esc to clear prompt when it's not empty by @Adib234 in
316
+ [#17131](https://github.com/google-gemini/gemini-cli/pull/17131)
317
+ - Avoid spurious warnings about unexpected renders triggered by appEvents and
318
+ coreEvents. by @jacob314 in
319
+ [#17160](https://github.com/google-gemini/gemini-cli/pull/17160)
320
+ - fix(cli): resolve home/end keybinding conflict by @scidomino in
321
+ [#17124](https://github.com/google-gemini/gemini-cli/pull/17124)
322
+ - fix(cli): display 'http' type on mcp list by @pamanta in
323
+ [#16915](https://github.com/google-gemini/gemini-cli/pull/16915)
324
+ - fix bad fallback logic external editor logic by @scidomino in
325
+ [#17166](https://github.com/google-gemini/gemini-cli/pull/17166)
326
+ - Fix bug where System scopes weren't migrated. by @jacob314 in
327
+ [#17174](https://github.com/google-gemini/gemini-cli/pull/17174)
328
+ - Fix mcp tool lookup in tool registry by @werdnum in
329
+ [#17054](https://github.com/google-gemini/gemini-cli/pull/17054)
127
330
 
128
- **Full Changelog**:
129
- https://github.com/google-gemini/gemini-cli/compare/v0.21.0-preview.6...v0.22.0-preview.0
331
+ **Full changelog**:
332
+ https://github.com/google-gemini/gemini-cli/compare/v0.25.0-preview.4...v0.26.0-preview.0
@@ -73,6 +73,9 @@ Slash commands provide meta-level control over the CLI itself.
73
73
  - **`/copy`**
74
74
  - **Description:** Copies the last output produced by Gemini CLI to your
75
75
  clipboard, for easy sharing or reuse.
76
+ - **Behavior:**
77
+ - Local sessions use system clipboard tools (pbcopy/xclip/clip).
78
+ - Remote sessions (SSH/WSL) use OSC 52 and require terminal support.
76
79
  - **Note:** This command requires platform-specific clipboard tools to be
77
80
  installed.
78
81
  - On Linux, it requires `xclip` or `xsel`. You can typically install them
@@ -164,6 +167,7 @@ Slash commands provide meta-level control over the CLI itself.
164
167
  - **Note:** Only available if checkpointing is configured via
165
168
  [settings](../get-started/configuration.md). See
166
169
  [Checkpointing documentation](../cli/checkpointing.md) for more details.
170
+
167
171
  - **`/resume`**
168
172
  - **Description:** Browse and resume previous conversation sessions. Opens an
169
173
  interactive session browser where you can search, filter, and select from
@@ -194,6 +198,23 @@ Slash commands provide meta-level control over the CLI itself.
194
198
  modify them as desired. Changes to some settings are applied immediately,
195
199
  while others require a restart.
196
200
 
201
+ - [**`/skills`**](./skills.md)
202
+ - **Description:** (Experimental) Manage Agent Skills, which provide on-demand
203
+ expertise and specialized workflows.
204
+ - **Sub-commands:**
205
+ - **`list`**:
206
+ - **Description:** List all discovered skills and their current status
207
+ (enabled/disabled).
208
+ - **`enable`**:
209
+ - **Description:** Enable a specific skill by name.
210
+ - **Usage:** `/skills enable <name>`
211
+ - **`disable`**:
212
+ - **Description:** Disable a specific skill by name.
213
+ - **Usage:** `/skills disable <name>`
214
+ - **`reload`**:
215
+ - **Description:** Refresh the list of discovered skills from all tiers
216
+ (workspace, user, and extensions).
217
+
197
218
  - **`/stats`**
198
219
  - **Description:** Display detailed statistics for the current Gemini CLI
199
220
  session, including token usage, cached token savings (when available), and
@@ -50,7 +50,7 @@ Your command definition files must be written in the TOML format and use the
50
50
  ## Handling arguments
51
51
 
52
52
  Custom commands support two powerful methods for handling arguments. The CLI
53
- automatically chooses the correct method based on the content of your command\'s
53
+ automatically chooses the correct method based on the content of your command's
54
54
  `prompt`.
55
55
 
56
56
  ### 1. Context-aware injection with `{{args}}`
@@ -96,13 +96,13 @@ Search Results:
96
96
  """
97
97
  ```
98
98
 
99
- When you run `/grep-code It\'s complicated`:
99
+ When you run `/grep-code It's complicated`:
100
100
 
101
101
  1. The CLI sees `{{args}}` used both outside and inside `!{...}`.
102
- 2. Outside: The first `{{args}}` is replaced raw with `It\'s complicated`.
102
+ 2. Outside: The first `{{args}}` is replaced raw with `It's complicated`.
103
103
  3. Inside: The second `{{args}}` is replaced with the escaped version (e.g., on
104
104
  Linux: `"It\'s complicated"`).
105
- 4. The command executed is `grep -r "It\'s complicated" .`.
105
+ 4. The command executed is `grep -r "It's complicated" .`.
106
106
  5. The CLI prompts you to confirm this exact, secure command before execution.
107
107
  6. The final prompt is sent.
108
108
 
@@ -129,13 +129,13 @@ format and behavior.
129
129
  # In: <project>/.codefly/commands/changelog.toml
130
130
  # Invoked via: /changelog 1.2.0 added "Support for default argument parsing."
131
131
 
132
- description = "Adds a new entry to the project\'s CHANGELOG.md file."
132
+ description = "Adds a new entry to the project's CHANGELOG.md file."
133
133
  prompt = """
134
134
  # Task: Update Changelog
135
135
 
136
136
  You are an expert maintainer of this software project. A user has invoked a command to add a new entry to the changelog.
137
137
 
138
- **The user\'s raw command is appended below your instructions.**
138
+ **The user's raw command is appended below your instructions.**
139
139
 
140
140
  Your task is to parse the `<version>`, `<change_type>`, and `<message>` from their input and use the `write_file` tool to correctly update the `CHANGELOG.md` file.
141
141
 
@@ -147,7 +147,7 @@ The command follows this format: `/changelog <version> <type> <message>`
147
147
  1. Read the `CHANGELOG.md` file.
148
148
  2. Find the section for the specified `<version>`.
149
149
  3. Add the `<message>` under the correct `<type>` heading.
150
- 4. If the version or type section doesn\'t exist, create it.
150
+ 4. If the version or type section doesn't exist, create it.
151
151
  5. Adhere strictly to the "Keep a Changelog" format.
152
152
  """
153
153
  ```
@@ -241,7 +241,7 @@ operate on specific files.
241
241
  **Example (`review.toml`):**
242
242
 
243
243
  This command injects the content of a _fixed_ best practices file
244
- (`docs/best-practices.md`) and uses the user\'s arguments to provide context for
244
+ (`docs/best-practices.md`) and uses the user's arguments to provide context for
245
245
  the review.
246
246
 
247
247
  ```toml
@@ -293,7 +293,7 @@ practice.
293
293
  description = "Asks the model to refactor the current context into a pure function."
294
294
 
295
295
  prompt = """
296
- Please analyze the code I\'ve provided in the current context.
296
+ Please analyze the code I've provided in the current context.
297
297
  Refactor it into a pure function.
298
298
 
299
299
  Your response should include:
@@ -25,10 +25,12 @@ overview of Gemini CLI, see the [main documentation page](../index.md).
25
25
 
26
26
  - **[Checkpointing](./checkpointing.md):** Automatically save and restore
27
27
  snapshots of your session and files.
28
- - **[Enterprise configuration](./enterprise.md):** Deploying and manage Gemini
29
- CLI in an enterprise environment.
28
+ - **[Enterprise configuration](./enterprise.md):** Deploy and manage Gemini CLI
29
+ in an enterprise environment.
30
30
  - **[Sandboxing](./sandbox.md):** Isolate tool execution in a secure,
31
31
  containerized environment.
32
+ - **[Agent Skills](./skills.md):** (Experimental) Extend the CLI with
33
+ specialized expertise and procedural workflows.
32
34
  - **[Telemetry](./telemetry.md):** Configure observability to monitor usage and
33
35
  performance.
34
36
  - **[Token caching](./token-caching.md):** Optimize API costs by caching tokens.
@@ -38,6 +40,8 @@ overview of Gemini CLI, see the [main documentation page](../index.md).
38
40
  files and directories from being accessed by tools.
39
41
  - **[Context files (CODEFLY.md)](./codefly-md.md):** Provide persistent,
40
42
  hierarchical context to the model.
43
+ - **[OpenSpec](./openspec.md):** An AI-native system for spec-driven development
44
+ workflows.
41
45
  - **[System prompt override](./system-prompt.md):** Replace the built‑in system
42
46
  instructions using `GEMINI_SYSTEM_MD`.
43
47