https://github.com/derailed-dash/adk-docs-ext
Provides Gemini with up-to-date information about ADK. The documentation content is sourced from llms.txt - either from the official ADK-Docs repo, or one you supply.
https://github.com/derailed-dash/adk-docs-ext
adk agent-development-kit gemini-cli gemini-cli-extensions mcp-server
Last synced: 2 months ago
JSON representation
Provides Gemini with up-to-date information about ADK. The documentation content is sourced from llms.txt - either from the official ADK-Docs repo, or one you supply.
- Host: GitHub
- URL: https://github.com/derailed-dash/adk-docs-ext
- Owner: derailed-dash
- Created: 2025-09-13T20:41:10.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-12-06T11:36:52.000Z (4 months ago)
- Last Synced: 2025-12-10T05:51:39.930Z (4 months ago)
- Topics: adk, agent-development-kit, gemini-cli, gemini-cli-extensions, mcp-server
- Homepage: https://medium.com/google-cloud/give-your-ai-agents-deep-understanding-with-llms-txt-4f948590332b
- Size: 39.1 KB
- Stars: 9
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-gemini-cli-extensions - adk-docs-ext - ADK Docs Extension for Gemini CLI. (Development)
README
# ADK Docs Extension for Gemini CLI
This extension provides documentation support for using the [Agent Development Kit (ADK)](https://google.github.io/adk-docs/).
## Repo Metadata
Author: Darren Lester
## How It Works
This Gemini CLI extension uses the [MCP LLMS-TXT Doc Server](https://pypi.org/project/mcpdoc/) to provide the Gemini model with up-to-date information about ADK. The documentation content is sourced from the `llms.txt` file in the [official ADK-Docs](https://github.com/google/adk-docs). This file is effectively a sitemap of the ADK documentation.
The extension's `GEMINI.md` file provides instructions to the Gemini model, guiding it to use the tools provided by this extension when answering questions about ADK.
## Why Is This Useful?
This extension empowers Gemini CLI to provide accurate and current information about ADK, without relying on potentially outdated internal knowledge. This is particularly useful for:
* Answering questions about ADK's features and APIs.
* Assisting with development tasks related to ADK.
* Ensuring that the information provided by the Gemini CLI is consistent with the latest ADK documentation.
## Extension Installation into Gemini CLI
The easiest way to install this extension is with this command:
```bash
gemini extensions install https://github.com/derailed-dash/adk-docs-ext
```
The command will respond with:
`Extension "adk-docs-ext" installed successfully and enabled.`
Alternatively, you can clone this repo directly into your `extensions` folder.
For global installation:
```bash
mkdir -p ~/.gemini/extensions
git clone https://github.com/derailed-dash/adk-docs-ext.git ~/.gemini/extensions/adk-docs-ext
```
For workspace-level installation:
```bash
mkdir -p ./.gemini/extensions
git clone https://github.com/derailed-dash/adk-docs-ext.git ./.gemini/extensions/adk-docs-ext
```
Gemini CLI will automatically load the extension on startup and will then use the relevant tools to answer any questions relating to ADK.
### Using an Alternative `llms.txt` Path
You may prefer to specify an alternate location for your `llms.txt`, such as a local copy of the file that you generate using a custom tool.
To use it, amend the `gemini-extension.json` and replace this:
```json
"--urls",
"https://google.github.io/adk-docs/llms.txt",
```
with this:
```json
"--urls",
"Local_ADK_Docs:/path/to/local/llms.txt",
```
E.g. if you're using the provided sample:
```json
{
"name": "adk-docs-ext",
"version": "1.0.2",
"mcpServers": {
"adk-docs-mcp": {
"command": "uvx",
"args": [
"--from",
"mcpdoc",
"mcpdoc",
"--urls",
"Local_ADK_Docs:${extensionPath}/sample_llms_txt/local_adk_docs_llms.txt",
"--allowed-domains",
"*",
"--transport",
"stdio"
]
}
},
"contextFileName": "GEMINI.md"
}
```
## Acknowledgements
This extension was inspired by the [gemini-docs-ext](https://github.com/markmcd/gemini-docs-ext) by Mark McDonald.