{
  "markdown": "# Rill Gemini Extension\n\nData analysis using Rill's metrics layer via Model Context Protocol for **Google Gemini CLI**.\n\nThis extension enables Google's Gemini AI assistant to query and analyze your Rill data directly through natural language conversations. Using the Google Gemini CLI and the Model Context Protocol (MCP), you can explore metrics, identify trends, and generate insights without writing queries manually.\n\n## Prerequisites\n\n- A Rill project or cloud account — get started [here](https://docs.rilldata.com/)\n- [Rill CLI](https://docs.rilldata.com/install)\n- [Google Gemini CLI](https://github.com/google-gemini/gemini-cli)\n\n## Installation\n\nInstall the extension with the Google Gemini CLI:\n\n```bash\ngemini extensions install https://github.com/rilldata/rill-gemini-extension\n```\n\nYou will be prompted to provide your Rill organization and project.\n\n```bash\n# You should see 'rill' listed among installed extensions\ngemini extensions list\n```\n\nRill Supports MCP Oauth authentication.\n```bash\n/mcp auth rill\n```\n\n## Usage\n\nOnce installed and configured, you can start using the Rill extension in your Google Gemini CLI conversations. Simply ask questions about your Rill metrics views, and the extension will generate insights based on your data.\n\n```shell\ngemini \"Using Rill, tell me about any trends you see in the Ads Bids dataview\"\n```\n\n> Example output: [Analysis](docs/sample.md)\n\n```shell\ngemini \"Tell me about the top publishers by ad spend in the Ads Bids dataview\"\n```\n\n```shell\nBased on my initial analysis, I'll focus on the top named publishers: KrushMedia, Sinclair Broadcasting, and Taboola.\n\nHere's a breakdown of the top 10 publishers by ad spend:\n\n  ┌──────────────────────────────────────┬───────────────────┬─────────────┐\n  │ Publisher                            │ Advertising Spend │ Impressions │\n  ├──────────────────────────────────────┼───────────────────┼─────────────┤\n  │ KrushMedia                           │ $755,058.21       │ 50,219      │\n  │ Sinclair Broadcasting - Bally Sports │ $419,923.62       │ 30,002      │\n  │ Taboola                              │ $408,628.51       │ 81,782      │\n  │ PubWise                              │ $202,980.07       │ 26,089      │\n  │ Disney                               │ $48,075.66        │ 4,055       │\n  │ Connatix                             │ $40,485.67        │ 7,090       │\n  │ Spot.IM                              │ $38,171.29        │ 6,576       │\n  │ Pluto TV                             │ $36,175.64        │ 4,396       │\n  │ fubo.TV New                          │ $23,563.37        │ 1,641       │\n  └──────────────────────────────────────┴───────────────────┴─────────────┘\n```\n\n> Examples used: [Examples](https://github.com/rilldata/rill?tab=readme-ov-file#production-examples)\n\n### Custom Slash Commands\n\nThis extension includes custom slash commands for common Rill analysis workflows. Use these commands in your Google Gemini CLI conversations to streamline your data exploration:\n\n#### Available Commands\n\n- **`/rill:metrics`** - List all available metrics views in your Rill project with descriptions\n- **`/rill:explore`** - Start a comprehensive OODA loop analysis for a specific metrics view\n- **`/rill:trends`** - Analyze time-based trends with automatic granularity selection\n- **`/rill:compare`** - Compare metrics across dimensions or time periods\n- **`/rill:timerange`** - Check the available time range and data freshness for a metrics view\n\n## Uninstallation\n\n```bash\ngemini extensions uninstall rill\n```\n\n## Troubleshooting\n\n### What the installer prompts mean\n\nWhen running the installer you may be asked for Organization, Project, and a user/service token — these are prompts to help populate the extension's configuration. The values will be saved to a `.env` file in the extension’s directory (e.g., `~/.gemini/extensions/rill/.env`).\n\n- `Keychain not available` — this is informational, not fatal. It indicates the installer couldn't store credentials in the OS keychain and will fall back to file-based storage.\n\n### Connection Issues\n\nIf you can't connect to your Rill project:\n\n- Verify your `.env` file or inputs contain valid credentials\n  - Confirm your user/service token has the necessary permissions\n- Check that your organization and project names match your Rill Cloud URL\n\n## Development\n\n### Local Development\n\nTo test changes locally:\n\n1. Make your changes to the extension files\n\n2. Install the extension from your local development directory:\n\n```bash\nnpm run link\n```\n\n3. Test the extension with the Google Gemini CLI, then unlink when done:\n\n```bash\nnpm run unlink\n```\n\n### Releasing\n\nThis extension is distributed through [GitHub Releases](https://docs.github.com/en/repositories/releasing-projects-on-github/about-releases)\n",
  "bytes": 4774,
  "sha": "cd67a2a87f1a79df4b262bc70d35cb428052e3e2a874c256bac624645d5af208",
  "repo_slug": "rilldata/rill-gemini-extension",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_rilldata_rill_gemini_extension_88e12cad/readme"
}