{
  "markdown": "# kojo-deploy-ai\n\n[![npm package](https://img.shields.io/badge/npm-kojo--deploy-blue)](https://www.npmjs.com/package/kojo-deploy)\n[![github repo](https://img.shields.io/badge/github-repo-black?logo=github)](https://github.com/KojoShaddy/Kojo-Deploy)\n\n### The AI Orchestrator for Google Cloud Run.\n\n`kojo-deploy-ai` is a Gemini CLI extension that brings natural language power to your Google Cloud infrastructure. Built on the Model Context Protocol (MCP), it wraps the `kojo-deploy` toolkit to allow you to manage, monitor, and push containerized services to Google Cloud Run using simple conversational commands.\n\n## Why kojo-deploy-ai?\n\n- **Zero-Install Execution**: Uses `npx` to ensure you always have the latest deployment logic without global bloat.\n- **AI-Driven Workflows**: Instead of memorizing complex flags, tell Gemini what you want to achieve.\n- **GCP Optimized**: Specifically tuned for Google Cloud Run environments, handling service names, regions, and environment flags natively.\n- **MCP Standard**: Built on the Model Context Protocol, ensuring a standardized \"bridge\" between the LLM and your local system.\n- **Windows Optimized**: Includes native support for Windows environments, resolving common execution policy and path issues.\n\n## Prerequisites\n\n- **Gemini CLI**: Install the official AI agent for your terminal: `npm install -g @google/gemini-cli`\n- **Google Cloud CLI**: Ensure the `gcloud` tool is installed and authenticated (`gcloud auth login`) so the extension can interact with your Google Cloud account.\n- **Node.js**: Version 20 or higher is required.\n\n## Installation\n\nYou can install `kojo-deploy-ai` directly from GitHub with one command:\n\n```bash\ngemini extensions install https://github.com/KojoShaddy/kojo-deploy-ai\n```\n\n## Getting Started\n\nOnce installed, simply type `gemini` in your terminal to start the interactive mode. You don't need to manually create any configuration files. Just ask the AI to help you get started:\n\n> \"I want to deploy this folder to Google Cloud Run. Can you help me set it up?\"\n\n## Usage Examples\n\nOpen the Gemini CLI by typing `gemini` in your terminal. You can now manage your Cloud Run services using natural language:\n\n### Deploying to Cloud Run\n> \"Deploy the billing-api service to production.\"\n- **Action**: Executes `npx kojo-deploy push billing-api --env prod`\n\n### Checking Service Status\n> \"What is the current status of my web-frontend on Google Cloud?\"\n- **Action**: Executes `npx kojo-deploy status web-frontend`\n\n### Intelligent Troubleshooting\n> \"The last deployment failed. Can you check the status of the auth-service and explain what might be wrong?\"\n\n## How it Works\n\nThis extension acts as an **MCP Server**. It creates a virtual bridge using Standard I/O to communicate with the Gemini CLI. When you give a command, the AI maps your intent to specialized tools:\n\n| Tool | Action | Description |\n| :--- | :--- | :--- |\n| `initialize_project` | `npx kojo-deploy init` | Automatically creates `kojo.json` with your project settings. |\n| `deploy_service` | `npx kojo-deploy push` | Triggers a Cloud Build and deploys a new revision to Cloud Run. |\n| `get_deploy_status` | `npx kojo-deploy status` | Fetches the URL, traffic split, and health of the service. |\n\n## Troubleshooting\n\n### Windows Installation Issues\nIf you encounter an `EBUSY` error or folder locking issues while installing on Windows, please refer to the [Windows Fix Guide](WINDOWS_FIX.md).\n\n## Uninstallation & Disabling\n\n### 1. The Standard Uninstall\nThe cleanest way to remove it completely from your Gemini CLI is by using the uninstall command:\n\n```bash\ngemini extensions uninstall kojo-deploy-ai\n```\n\n### 2. The \"Soft\" Disable\nIf you don't want to delete it but just want to turn it off so Gemini stops using those tools for a while, you can simply disable it:\n\n```bash\ngemini extensions disable kojo-deploy-ai\n```\n\nTo turn it back on later, just run `gemini extensions enable kojo-deploy-ai`.\n\n## Local Development\n\nIf you want to modify the extension or test changes locally:\n\n1. Clone the repository.\n2. Install dependencies: `npm install`.\n3. Link the extension to your Gemini CLI:\n   ```bash\n   gemini extensions install .\n   ```\n\n## Contributing\n\nWhether it's adding support for Cloud Functions, Secret Manager, or improving the AI's reasoning, feel free to open an issue or submit a PR.\n\n## License\n\nThis project is licensed under the MIT License.\n\n---\n\nBuilt with ❤️ by **Shadrack Inusah (Kojo Shaddy)**\n*Software Developer | Open Source Contributor | Lead @ GDG Accra*\n",
  "bytes": 4540,
  "sha": "d69c4860a51f40e4c80fbfeda59cc51f384d2a1a18fb735788874d60f1a2572b",
  "repo_slug": "kojoshaddy/kojo-deploy-ai",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_kojoshaddy_kojo_deploy_ai_0399bff9/readme"
}