genkit-secrets-manager

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

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

1. Install the plugin:

`` /plugin install genkit ``

1. Verify installation:

`` /genkit-doctor ``

From Local Directory

1. Install the plugin:

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

1. Enable the plugin:

`` /plugin enable genkit ``

1. 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

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: [email protected]

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!