> ## Documentation Index
> Fetch the complete documentation index at: https://docs.context.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini CLI

> Add Context.dev live web and document intelligence to Gemini CLI with the official extension.

The Context.dev extension gives Gemini CLI live web and document context through a hosted MCP server and an on-demand skill. Search the web, follow company news, scrape pages and YouTube transcripts, crawl sites, extract structured data, parse documents, and retrieve brand intelligence without copying an API key into Gemini CLI.

<Card title="Install Context.dev for Gemini CLI" icon="download" href="https://github.com/context-dot-dev/gemini-cli-context">
  Review the official extension source and latest release on GitHub.
</Card>

## Prerequisites

* [Gemini CLI](https://github.com/google-gemini/gemini-cli) installed and signed in
* A browser available for Context.dev authorization
* A [Context.dev account](https://context.dev/signup) with credits for tool calls

## Install and connect

<Steps>
  <Step title="Install the extension">
    Run the following command in your terminal:

    ```bash theme={null}
    gemini extensions install https://github.com/context-dot-dev/gemini-cli-context --auto-update --consent
    ```

    The extension is installed from the latest public Context.dev release and will receive future updates automatically.
  </Step>

  <Step title="Start a new Gemini CLI session">
    Exit any session that was already open, then start Gemini CLI again. The extension loads the `context` MCP server and the `context-dev` skill when the new session starts.
  </Step>

  <Step title="Authorize Context.dev">
    Make your first Context.dev request. Gemini CLI opens your browser so you can sign in or create an account, approve access, and return to the terminal.

    If the browser does not open, run this inside Gemini CLI:

    ```text theme={null}
    /mcp auth context
    ```
  </Step>

  <Step title="Confirm the extension loaded">
    Run `gemini extensions list` in your terminal. The output should show `gemini-cli-context`, the `context` MCP server, and the `context-dev` agent skill.

    Inside Gemini CLI, use `/mcp` to inspect the connected tools and `/skills list` to confirm that `context-dev` is available.
  </Step>
</Steps>

<Info>
  The extension uses Context.dev's browser-based OAuth flow. Do not add an API key, bearer token, or custom header to the extension configuration.
</Info>

## Verify the setup

Send a small, read-only request whose output is easy to inspect:

```text theme={null}
Use Context.dev to scrape https://www.context.dev and return the page title and source URL.
```

Confirm that Gemini CLI shows a successful Context.dev tool call with live output. A response produced without a Context.dev tool call does not verify the connection.

## Use the extension

Ask for the result you want. The bundled skill routes the task to the smallest suitable Context.dev tool.

| Task                      | Example request                                                                                            |
| ------------------------- | ---------------------------------------------------------------------------------------------------------- |
| Search the live web       | `Use Context.dev to find the latest official Gemini CLI announcements and cite the source URLs.`           |
| Search company news       | `Use Context.dev to find Stripe's latest company news and link every source.`                              |
| Read a known page         | `Use Context.dev to scrape this page as clean Markdown: <url>`                                             |
| Summarize a YouTube video | `Use Context.dev to scrape this YouTube video as a timestamped transcript and summarize it: <youtube-url>` |
| Extract structured data   | `Use Context.dev to extract every pricing plan from this site as JSON with name, price, and limits: <url>` |
| Parse a document          | `Use Context.dev to parse this PDF and summarize the findings with page references: <file-url>`            |
| Retrieve a brand profile  | `Use Context.dev to retrieve the logo, colors, fonts, and social profiles for linear.app.`                 |
| Research one website      | `Use Context.dev to discover and crawl the documentation pages about authentication on this site: <url>`   |

Context.dev also exposes screenshots, website style guides, industry classification, monitors, and asynchronous batches through the same connection.

<Warning>
  Monitor and batch tools can create or change persistent account state. Ask for create, update, run, cancel, or delete operations explicitly and review the tool call before approving it.
</Warning>

## Manage the extension

<CodeGroup>
  ```bash Update theme={null}
  gemini extensions update gemini-cli-context
  ```

  ```bash List theme={null}
  gemini extensions list
  ```

  ```bash Uninstall theme={null}
  gemini extensions uninstall gemini-cli-context
  ```
</CodeGroup>

## Troubleshooting

| Symptom                                         | Fix                                                                                                                                 |
| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| The extension is not listed                     | Install it again from the GitHub URL, then run `gemini extensions list`.                                                            |
| The `context` server is missing                 | Start a new Gemini CLI session and inspect `/mcp`. If the extension is disabled, run `gemini extensions enable gemini-cli-context`. |
| Authorization does not start                    | Run `/mcp auth context`, finish the browser flow, and return to Gemini CLI.                                                         |
| Gemini reports `401` or authentication required | Reconnect with `/mcp auth context` and complete authorization again.                                                                |
| The `context-dev` skill is missing              | Start a new session and run `/skills list`. Update or reinstall the extension if it remains unavailable.                            |
| Calls fail for insufficient credits             | Review usage in the [Context.dev dashboard](https://context.dev/dashboard); repeated retries will not add credits.                  |

## Reference

<CardGroup cols={2}>
  <Card title="Extension source" icon="github" href="https://github.com/context-dot-dev/gemini-cli-context">
    Inspect the manifest, MCP configuration, skill, tests, and releases.
  </Card>

  <Card title="Gemini CLI extension docs" icon="book" href="https://geminicli.com/docs/extensions/">
    Official installation, management, and extension-authoring guidance.
  </Card>

  <Card title="Context.dev MCP guide" icon="robot" href="/install-mcp">
    Hosted server capabilities and OAuth details.
  </Card>

  <Card title="Context.dev dashboard" icon="gauge" href="https://context.dev/dashboard">
    Review account credits and usage.
  </Card>
</CardGroup>