Genkit Plugin for Claude Code

Build production-ready AI applications with Genkit directly from Claude Code

A comprehensive Claude Code plugin that streamlines Genkit development with intelligent commands, templates, and an AI assistant specialized in Genkit best practices.

🎉 Now Available: VS Code Extension!

The official Genkit for VS Code extension is now live on the VS Code Marketplace!

Quick Install:

ext install amitpatole.genkit-vscode

Features:

• ⚡ 6 Genkit commands in Command Palette
• 📝 7+ code snippets for rapid development
• 🔍 Genkit Explorer sidebar with project navigation
• ⚙️ Customizable settings and auto-start dev server
• 🖥️ Cross-platform: Windows, Linux, macOS

📖 Extension Documentation | 🚀 Quick Start Guide

---

🤖 Autonomous Agents (NEW!)

This repository is monitored and maintained by autonomous agents running 24/7:

Schedule Enforcement Agent

• ✅ Runs every 5 minutes
• ✅ Enforces deployment window: 10 PM - 8 AM EST
• ✅ Blocks deployments outside allowed hours
• ✅ Generates violation reports

Monitoring & Maintenance Agent

• ✅ Runs every 10 minutes
• ✅ Auto-fixes compilation errors
• ✅ Auto-updates dependencies & security patches
• ✅ Responds to GitHub issues automatically
• ✅ Tracks marketplace metrics
• ✅ Researches new features

Learn More:

• 📖 Agent Documentation - Full details on how agents work
• ⚡ Quick Start Guide - Get started in 2 minutes
• ⚙️ Configuration - Agent settings

Agent Status:

# Check if agents are running
cat .github/agent-status/*.txt

# View recent reports
ls -lt agent-reports/

---

Features

🚀 Quick Project Initialization

• /genkit-init - Create new Genkit projects with interactive setup
  • TypeScript, JavaScript, Go, or Python support
  • Multiple AI providers (Claude, Gemini, GPT)
  • Pre-configured project structure
  • Example flows to get started

💻 Development Tools

• /genkit-run - Start Genkit dev server with auto-configuration
  • Automatic dependency detection
  • Smart .env file management
  • Genkit Developer UI at localhost:4000
  • Hot reload support

📦 Flow Generation

• /genkit-flow - Create flows from templates
  • Simple Chat Flow
  • RAG (Retrieval Augmented Generation)
  • Tool Calling with function execution
  • Multi-step workflows
  • Streaming responses
  • Blank templates

🌐 Deployment Support

• /genkit-deploy - Deploy to multiple platforms
  • Firebase Cloud Functions
  • Google Cloud Run
  • Google Cloud Functions (2nd gen)
  • Vercel
  • Docker containers
  • Local builds

🏥 Health Monitoring

• /genkit-doctor - Comprehensive project health checks
  • System requirements validation
  • Package installation verification
  • Configuration file checks
  • Environment variable validation
  • Flow detection
  • Dependency health

🤖 AI Assistant

• Genkit-specialized AI agent with deep expertise in:
  • Genkit architecture and patterns
  • AI model integration
  • Production deployment strategies
  • Performance optimization
  • Security best practices

Installation

From GitHub (Recommended)

1. Add the marketplace:

   /plugin marketplace add https://github.com/amitpatole/claude-genkit-plugin.git

2. Install the plugin:

   /plugin install genkit

3. Verify installation:

   /genkit-doctor

From Local Directory

1. Install the plugin:

   /plugin install /path/to/claude-genkit-plugin

2. Enable the plugin:

   /plugin enable genkit

3. Verify installation:

   /genkit-doctor

Quick Start

Create Your First Genkit Project

# 1. Initialize a new project
/genkit-init

# Follow the interactive prompts:
# - Project name: my-ai-app
# - Language: TypeScript
# - AI Provider: Anthropic Claude

# 2. Navigate to your project
cd my-ai-app

# 3. Add your API keys to .env
# Edit .env and add:
# ANTHROPIC_API_KEY=your_key_here

# 4. Start development server
/genkit-run

# 5. Open Genkit Developer UI
# Visit http://localhost:4000

Create a New Flow

# In your Genkit project
/genkit-flow

# Follow prompts:
# - Flow name: summarizeFlow
# - Template: RAG (Retrieval Augmented Generation)

Deploy to Production

/genkit-deploy

# Choose deployment target:
# 1. Firebase Cloud Functions
# 2. Google Cloud Run
# 3. Vercel
# etc.

Commands Reference

Command	Description	Usage
/genkit-init	Initialize new Genkit project	Interactive setup wizard
/genkit-run	Start development server	Run from project directory
/genkit-flow	Generate new flow from template	Choose from 6 templates
/genkit-deploy	Deploy to production	Multiple platform support
/genkit-doctor	Health check and diagnostics	Validates entire setup

Supported Technologies

Languages

• ✅ TypeScript (Recommended)
• ✅ JavaScript
• ✅ Go (Beta)
• ✅ Python (Alpha)

AI Models

• 🤖 Anthropic Claude (3.5 Sonnet, 3 Opus, etc.)
• 🧠 Google Gemini (1.5 Pro, 1.5 Flash)
• 💬 OpenAI GPT (GPT-4, GPT-3.5)
• 🏠 Local Models (via Ollama)

Deployment Platforms

• 🔥 Firebase Cloud Functions
• ☁️ Google Cloud Run
• ⚡ Google Cloud Functions (2nd gen)
• 🔺 Vercel
• 🐳 Docker
• 🌐 Custom platforms

Flow Templates

1. Simple Chat

Basic conversational AI flow with single-turn responses.

2. RAG (Retrieval Augmented Generation)

Query documents and generate answers with context.

3. Tool Calling

Execute functions and tools based on AI decisions.

4. Multi-step

Complex workflows with sequential AI operations.

5. Streaming

Real-time streaming responses for better UX.

6. Empty

Blank template for custom implementations.

AI Assistant

The plugin includes a specialized AI agent with expertise in:

• Architecture Design - Design scalable Genkit applications
• Code Generation - Create production-ready flows and tools
• Debugging - Troubleshoot configuration and runtime issues
• Optimization - Improve performance, reduce costs
• Best Practices - Security, error handling, testing

Activate the assistant:

@genkit-assistant How do I implement a RAG flow with Claude?

Examples

Example 1: Chat Application

import { defineFlow } from '@genkit-ai/flow';
import { claude35Sonnet } from '@genkit-ai/anthropic';
import { z } from 'zod';

export const chatFlow = defineFlow(
  {
    name: 'chat',
    inputSchema: z.object({
      message: z.string(),
      history: z.array(z.object({
        role: z.enum(['user', 'assistant']),
        content: z.string(),
      })).optional(),
    }),
    outputSchema: z.string(),
  },
  async (input) => {
    const messages = [
      ...(input.history || []),
      { role: 'user', content: input.message },
    ];

    const result = await claude35Sonnet.generate({
      messages,
    });

    return result.text;
  }
);

Example 2: RAG with Vector Search

export const ragFlow = defineFlow(
  {
    name: 'rag',
    inputSchema: z.object({
      question: z.string(),
      maxResults: z.number().default(5),
    }),
    outputSchema: z.object({
      answer: z.string(),
      sources: z.array(z.string()),
    }),
  },
  async (input) => {
    // Retrieve relevant documents
    const docs = await vectorStore.search(input.question, {
      limit: input.maxResults,
    });

    // Generate answer with context
    const result = await claude35Sonnet.generate({
      prompt: `Context:\n${docs.map(d => d.content).join('\n\n')}\n\nQuestion: ${input.question}\n\nAnswer:`,
    });

    return {
      answer: result.text,
      sources: docs.map(d => d.id),
    };
  }
);

Configuration

Environment Variables

Create a .env file in your project:

# Anthropic (Claude)
ANTHROPIC_API_KEY=sk-ant-...

# Google AI (Gemini)
GOOGLE_AI_API_KEY=AIza...

# OpenAI (GPT)
OPENAI_API_KEY=sk-...

# Optional: Custom configuration
PORT=3000
NODE_ENV=development

Genkit Configuration

Create src/genkit.config.ts:

import { configureGenkit } from '@genkit-ai/core';
import { claude } from '@genkit-ai/anthropic';
import { googleAI } from '@genkit-ai/googleai';

export default configureGenkit({
  plugins: [
    claude({
      apiKey: process.env.ANTHROPIC_API_KEY,
    }),
    googleAI({
      apiKey: process.env.GOOGLE_AI_API_KEY,
    }),
  ],
  logLevel: 'debug',
  enableTracingAndMetrics: true,
});

Troubleshooting

Common Issues

Issue: “Genkit CLI not found”

# Install globally
npm install -g genkit-cli

# Or run without global install
npx genkit start

Issue: “No API key configured”

# Copy example env file
cp .env.example .env

# Edit .env and add your keys
nano .env

Issue: “Port 4000 already in use”

# Kill existing process
lsof -ti:4000 | xargs kill -9

# Or change port in your start script
PORT=4001 npm run dev

Health Check

Run a comprehensive health check:

/genkit-doctor

Requirements

• Node.js 18+ (for JavaScript/TypeScript)
• npm 8+
• Go 1.21+ (for Go projects)
• Python 3.10+ (for Python projects)

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test with /genkit-doctor
5. Submit a pull request

Plugin Marketplace

This plugin is part of a comprehensive marketplace with 34 specialized plugins for Genkit development!

🎯 Core Plugin

• genkit - Main Genkit integration with initialization, templates, and deployment

🛠️ Development & Testing (7 plugins)

• genkit-test-writer - Automatic test generation
• genkit-architect - Architecture design guidance
• genkit-debugger - Interactive debugging
• genkit-validator - Input/output validation
• genkit-documentation - Auto-generate docs
• genkit-starter-kits - Production templates
• genkit-api-generator - REST/GraphQL APIs

🤖 AI Models & Optimization (4 plugins)

• genkit-ollama - Local AI models
• genkit-model-selector - Model comparison
• genkit-prompt-optimizer - Prompt engineering
• genkit-embedding-helper - Embeddings for RAG

💾 Database & Storage (4 plugins)

• genkit-firestore - Firestore integration
• genkit-vector-db - Vector databases
• genkit-cache - Caching strategies
• genkit-session-manager - Session management

📊 Monitoring & Performance (4 plugins)

• genkit-monitor - Real-time monitoring
• genkit-cost-tracker - Cost tracking
• genkit-performance-analyzer - Performance profiling
• genkit-logger - Enhanced logging

🔐 Security (3 plugins)

• genkit-security-auditor - Security auditing
• genkit-secrets-manager - Secrets management
• genkit-auth-helper - Authentication

🔄 Integration & Automation (5 plugins)

• genkit-migration-helper - Framework migration
• genkit-webhooks - Webhook integration
• genkit-scheduler - Scheduled tasks
• genkit-workflow-orchestrator - Workflows
• genkit-rate-limiter - Rate limiting

🎨 Media Processing (3 plugins)

• genkit-image - Image generation, editing, OCR
• genkit-audio - Audio transcription, TTS
• genkit-video - Video generation, editing

📝 Content Creation (2 plugins)

• genkit-content-studio - Multi-modal content
• genkit-analytics - Analytics insights
• genkit-ui-generator - UI components

Install specialized plugins:

/plugin install genkit-test-writer
/plugin install genkit-monitor
/plugin install genkit-image
# ... and 31 more!

Roadmap

✅ Completed

• ✅ Plugin marketplace submission (34 plugins live!)
• ✅ Additional flow templates (6 templates)
• ✅ Firebase integration helpers (genkit-firestore)
• ✅ Advanced monitoring tools (monitor, performance-analyzer, logger)
• ✅ Testing utilities (genkit-test-writer)
• ✅ Migration helpers (genkit-migration-helper)

🚀 Future Plans

• ✅ VS Code extension integration - COMPLETED!
  • 🎉 Published to VS Code Marketplace v1.0.1
  • 📦 Install from Marketplace
  • 💻 6 commands, 7+ snippets, Genkit Explorer sidebar
  • 📖 See vscode-extension/ directory for details
• ✅ CI/CD pipeline templates - COMPLETED!
  • 🚀 Production-ready templates for GitHub Actions, GitLab CI, Azure Pipelines
  • 📦 Multi-environment support (dev, staging, production)
  • 🔐 Security scanning, automated testing, health checks
  • 🎯 Multiple deployment targets (Firebase, Cloud Run, Vercel, AWS Lambda)
  • 📖 See cicd-templates/ directory for details
• ✅ Multi-region deployment - COMPLETED!
  • 🌍 Deploy across multiple geographic regions
  • ⚡ Active-active, active-passive, and geo-routing strategies
  • 🛡️ Automatic failover and health monitoring
  • 📊 Load balancing and traffic management
  • 📖 See multi-region/ directory for details
• ✅ Advanced RAG patterns - COMPLETED!
  • 🔍 8 production-ready RAG patterns (Hybrid, Hierarchical, Conversational, etc.)
  • 📊 Pattern comparison and use cases
  • 💡 Best practices for chunking, embedding, reranking
  • 📈 Evaluation metrics and optimization strategies
  • 📖 See advanced-rag/ directory for details
• ✅ Real-time collaboration - COMPLETED!
  • 💬 WebSocket server for bidirectional communication
  • 📡 Server-Sent Events for AI response streaming
  • 🤝 Multi-user collaboration examples
  • 🔔 Presence tracking and broadcasting
  • 📖 See realtime-collaboration/ directory for details
• ✅ Plugin SDK for extensions - COMPLETED!
  • 🔧 Complete plugin development framework
  • 📦 Packaging and distribution tools
  • 🧪 Testing utilities and examples
  • 📚 Documentation generators
  • 🚀 Publishing workflow to npm
  • 📖 See plugin-sdk/ directory for details

Resources

• Genkit Documentation
• Claude Code Documentation
• Anthropic API Reference
• Plugin Source Code

License

MIT License - see LICENSE file for details

Support

• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 📧 Email: amit.patole@gmail.com

Acknowledgments

• Genkit Team at Google
• Anthropic for Claude AI
• Claude Code Team at Anthropic

---

Made with ❤️ for the AI developer community

Build amazing AI applications with Genkit and Claude Code!