gemini-cli - 💡(How to fix) Fix Docs for bundling subagents as extensions are not available [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
google-gemini/gemini-cli#25845Fetched 2026-04-24 06:14:06
View on GitHub
Comments
0
Participants
1
Timeline
1
Reactions
0
Author
Participants
Timeline (top)
labeled ×1

Code Example

> /about
CLI Version                                                    0.38.2Git Commit                                                     b0ed611a0                                                                                                              │
Model                                                          Auto (Gemini 3)Sandbox                                                        no sandbox                                                                                                             │
OS                                                             darwin                                                                                                                 │
Auth Method                                                    gemini-api-key
RAW_BUFFERClick to expand / collapse

What happened?

The subagents docs talk about being able to bundle subagents into extensions. https://geminicli.com/docs/core/subagents/#extension-subagents

<img width="761" height="149" alt="Image" src="https://github.com/user-attachments/assets/94766267-a0a5-4a4d-909d-e8324a5b4a40" />

However the extensions docs has no entry about agents. https://geminicli.com/docs/extensions/writing-extensions/

What did you expect to happen?

I expected to see some documentation around packaging subagents into Extensions.

Client information

<details> <summary>Client Information</summary>

Run gemini to enter the interactive CLI, then run the /about command.

> /about
│ CLI Version                                                    0.38.2                                                                                                                 │
│ Git Commit                                                     b0ed611a0                                                                                                              │
│ Model                                                          Auto (Gemini 3)                                                                                                        │
│ Sandbox                                                        no sandbox                                                                                                             │
│ OS                                                             darwin                                                                                                                 │
│ Auth Method                                                    gemini-api-key```

</details>

### Login information

_No response_

### Anything else we need to know?

_No response_

extent analysis

TL;DR

The documentation for packaging subagents into extensions is missing, and users should check the Gemini CLI documentation for potential updates or workarounds.

Guidance

  • Review the Gemini CLI documentation for subagents and extensions to see if there are any updates or changes that may have affected the documentation.
  • Check the Gemini CLI GitHub repository for any open issues or pull requests related to subagent documentation in extensions.
  • Consider reaching out to the Gemini CLI support team or community forums for further assistance with packaging subagents into extensions.
  • Verify that the CLI version (0.38.2) is the latest version, as updates may have addressed the documentation issue.

Notes

The issue appears to be related to missing documentation, and there may be limitations in the current version of the Gemini CLI.

Recommendation

Apply workaround: Check the Gemini CLI documentation and GitHub repository for updates or alternative solutions, as the current documentation does not provide clear guidance on packaging subagents into extensions.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING