{
  "markdown": "[![Gemini CLI Extension](https://img.shields.io/badge/Gemini_CLI-Extension-4285F4?logo=google&logoColor=white)](https://geminicli.com/extensions/?name=carsxecarsxe-gemini-extension)\n\n# CarsXE Extension for Gemini CLI\n\nAccess the full suite of [CarsXE](https://api.carsxe.com) vehicle data APIs directly from Gemini CLI. Decode VINs, look up license plates, get market values, vehicle history, recalls, lien and theft records, OBD codes, and more.\n\n## Features\n\n| Command                                    | Description                                   |\n| ------------------------------------------ | --------------------------------------------- |\n| `/carsxe:auth <API_KEY>`                   | Validate and set your CarsXE API key          |\n| `/carsxe:specs <VIN>`                      | Decode a VIN with full vehicle specifications |\n| `/carsxe:plate <PLATE> <COUNTRY> [STATE]`  | Look up a vehicle by license plate            |\n| `/carsxe:value <VIN> [STATE] [MILEAGE] [CONDITION]` | Get current market value          |\n| `/carsxe:history <VIN>`                    | Full vehicle history report                   |\n| `/carsxe:images <MAKE> <MODEL> [YEAR]`     | Retrieve vehicle photos                       |\n| `/carsxe:recalls <VIN>`                    | Check for open safety recalls                 |\n| `/carsxe:intvin <VIN>`                     | Decode an international (non-US) VIN          |\n| `/carsxe:ocr <IMAGE_URL>`                  | Extract a VIN from a photo (OCR)              |\n| `/carsxe:lien <VIN>`                       | Check for liens and theft records             |\n| `/carsxe:plateocr <IMAGE_URL>`             | Extract a plate number from a photo           |\n| `/carsxe:ymm <YEAR> <MAKE> <MODEL> [TRIM]` | Look up by Year/Make/Model                    |\n| `/carsxe:obd <CODE>`                       | Decode an OBD-II trouble code                 |\n\nAll commands also have corresponding **skills** that Gemini auto-invokes when it detects relevant context in your conversation.\n\n## Prerequisites\n\nBefore installing the extension, make sure you have the [Gemini CLI](https://github.com/google-gemini/gemini-cli) installed and your `GEMINI_API_KEY` environment variable set.\n\nYou can get a Gemini API key from [Google AI Studio](https://aistudio.google.com/apikey).\n\n**macOS / Linux — add to your shell profile for persistence:**\n\n```bash\necho 'export GEMINI_API_KEY=your_gemini_api_key_here' >> ~/.bashrc\nsource ~/.bashrc\n```\n\n> If you use Zsh (default on macOS), replace `~/.bashrc` with `~/.zshrc`.\n\n**Windows — PowerShell (current session):**\n\n```powershell\n$env:GEMINI_API_KEY=\"your_gemini_api_key_here\"\n```\n\n**Windows — PowerShell (persist across sessions):**\n\n```powershell\n[System.Environment]::SetEnvironmentVariable(\"GEMINI_API_KEY\",\"your_gemini_api_key_here\",\"User\")\n```\n\n**Windows — Command Prompt:**\n\n```cmd\nsetx GEMINI_API_KEY \"your_gemini_api_key_here\"\n```\n\n> After `setx`, restart your terminal for the variable to take effect.\n\n## Installation\n\nInstall the extension from the GitHub repository:\n\n```bash\ngemini extensions install https://github.com/carsxe/carsxe-gemini-extension.git\n```\n\nDuring installation, Gemini CLI prompts you for your CarsXE API key. If you do not have a key yet, sign up and get one from the [CarsXE developer dashboard](https://api.carsxe.com/dashboard/developer).\n\nIf you skipped that prompt, or you want to change your API key after installing, run:\n\n```bash\ngemini extensions config carsxe\n```\n\nThis stores your API key securely in the system keychain.\n\n## Usage Examples\n\n### Decode a VIN\n\n```\n/carsxe:specs WBAFR7C57CC811956\n```\n\n### Look up a license plate\n\n```\n/carsxe:plate 7XER187 US CA\n```\n\n### Get market value\n\n```\n/carsxe:value WBAFR7C57CC811956\n/carsxe:value WBAFR7C57CC811956 CA 45000 clean\n```\n\nOptional params: state (e.g. `CA`), mileage, condition (`excellent` | `clean` | `average` | `rough`)\n\n### Vehicle history report\n\n```\n/carsxe:history WBAFR7C57CC811956\n```\n\n### Vehicle images\n\n```\n/carsxe:images BMW X5 2019\n```\n\n### Check recalls\n\n```\n/carsxe:recalls WBAFR7C57CC811956\n```\n\n### International VIN\n\n```\n/carsxe:intvin WF0MXXGBWM8R43240\n```\n\n### VIN OCR from image\n\n```\n/carsxe:ocr https://example.com/vin-photo.jpg\n```\n\n### Lien and theft check\n\n```\n/carsxe:lien WBAFR7C57CC811956\n```\n\n### Plate recognition from image\n\n```\n/carsxe:plateocr https://example.com/plate-photo.jpg\n```\n\n### Year/Make/Model lookup\n\n```\n/carsxe:ymm 2020 Toyota Camry LE\n```\n\n### OBD code decode\n\n```\n/carsxe:obd P0300\n```\n\n## Skills (Auto-invoked)\n\nGemini will automatically use the CarsXE tools when it detects relevant queries. For example:\n\n- _\"What can you tell me about VIN WBAFR7C57CC811956?\"_ — triggers the `vehicle-specs` skill\n- _\"Does this car have any recalls? VIN: WBAFR7C57CC811956\"_ — triggers the `vehicle-recalls` skill\n- _\"My check engine light is on with code P0300\"_ — triggers the `obd-decoder` skill\n- _\"How much is a 2012 BMW X5 worth? VIN WBAFR7C57CC811956\"_ — triggers the `market-value` skill\n\n## API Documentation\n\nFull API documentation is available at [api.carsxe.com/docs](https://api.carsxe.com/docs).\n\n## License\n\nMIT\n",
  "bytes": 5128,
  "sha": "358717faf0e0dbf42cad298fed5d9f589332729686840f9a9f0380e02e0cecee",
  "repo_slug": "carsxe/carsxe-gemini-extension",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_carsxe_carsxe_gemini_extension_18426e6f/readme"
}