claude-genkit-plugin

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

claude-genkit-plugin

★ 11 Open GitHub ↗

Firebase Genkit Plugin for Claude Code

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Genkit Plugin for Claude Code

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

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Claude Code Plugin](https://img.shields.io/badge/Claude%20Code-Plugin-blue.svg)](https://claude.com/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!

[![Install from Marketplace](https://img.shields.io/visual-studio-marketplace/v/amitpatole.genkit-vscode?label=VS%20Code%20Extension&logo=visualstudiocode)](https://marketplace.visualstudio.com/items?itemName=amitpatole.genkit-vscode)

**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](./vscode-extension/README.md) | [🚀 Quick Start Guide](./vscode-extension/QUICKSTART.md)

---

## 🤖 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](./AGENTS.md) - Full details on how agents work
- [⚡ Quick Start Guide](./AGENTS-QUICKSTART.md) - Get started in 2 minutes
- [⚙️ Configuration](/.github/agents-config.yml) - Agent settings

**Agent Status:**
```bash
# 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

```bash
# 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

```bash
# In your Genkit project
/genkit-flow

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

### Deploy to Production

```bash
/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

```typescript
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

```typescript
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:

```bash
# 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`:

```typescript
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"**
```bash
# Install globally
npm install -g genkit-cli

# Or run without global install
npx genkit start
```

**Issue: "No API key configured"**
```bash
# Copy example env file
cp .env.example .env

# Edit .env and add your keys
nano .env
```

**Issue: "Port 4000 already in use"**
```bash
# 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:**
```bash
/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](https://marketplace.visualstudio.com/items?itemName=amitpatole.genkit-vscode)
  - 💻 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]([https://firebase.google.com/docs/genkit](https://genkit.dev/docs/get-started/))
- [Claude Code Documentation](https://docs.claude.com/claude-code)
- [Anthropic API Reference](https://docs.anthropic.com/)
- [Plugin Source Code](https://github.com/amitpatole/claude-genkit-plugin)

## License

MIT License - see [LICENSE](LICENSE) file for details

## Support

- 🐛 **Issues**: [GitHub Issues](https://github.com/amitpatole/claude-genkit-plugin/issues)
- 💬 **Discussions**: [GitHub Discussions](https://github.com/amitpatole/claude-genkit-plugin/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!*

claude-genkit-plugin

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README