RepoTools

Name: RepoTools
Availability: InStock
Author: freshtechbro

RepoTools brings software development tools directly to your browser through a modern Chrome extension, built on the robust MCP server architecture.

GitHub Website Docs

GitHub Stars

User Rating

Not Rated

Favorites

Views

Forks

Issues

README

RepoTools - AI-Powered Development Tools

RepoTools brings powerful AI development tools directly to your browser through a modern Chrome extension, built on the robust Vibe-Coder-MCP server architecture. Get instant access to 14 AI-powered tools for code analysis, generation, and project management.

🚀 Chrome Extension + 🛠️ MCP Server = Complete AI Development Toolkit

🌐 Official Website: repotools.ai

🎯 For Users: Chrome Extension

✨ 14 Powerful AI Tools at Your Fingertips

Transform your development workflow with AI tools accessible directly from your browser:

🔍 Research - AI-powered topic research and analysis
📋 Generate Rules - Create project guidelines and coding standards
📄 Generate PRD - Comprehensive Product Requirements Documents
📖 Generate User Stories - Feature development user stories
✅ Generate Task List - Detailed project task breakdowns
🚀 Generate Fullstack Starter Kit - Complete project templates
⚡ Run Workflow - Automated development workflows
📊 Get Job Result - Monitor and retrieve job execution results
🗺️ Map Codebase - Generate semantic code maps and documentation
🎯 Vibe Task Manager - AI-powered task orchestration
🧠 Curate Context - Intelligent project context analysis
🤖 Register Agent - AI agent registration for automation
📋 Get Agent Tasks - Retrieve AI agent task assignments
✅ Submit Task Response - Submit AI agent execution results

🏗️ Architecture Overview

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│  Chrome         │    │  Local MCP       │    │  External APIs  │
│  Extension      │◄──►│  Server          │◄──�������│  (OpenRouter,   │
│  (RepoTools)    │    │  (Vibe-Coder)    │    │   Perplexity)   │
└─────────────────┘    └──────────────────┘    └─────────────────┘

🛠️ Quick Installation

Prerequisites

Node.js 18+
Chrome Browser
Local MCP server running

1. Install Chrome Extension

# Clone and build extension
cd chrome-extension
npm install
npm run build

# Load in Chrome
# 1. Open chrome://extensions/
# 2. Enable "Developer mode"
# 3. Click "Load unpacked" → select dist/ folder

2. Start Local Server

# Start the MCP server
npm install
npm run build
npm start

# Start lightweight server (for Chrome extension)
cd lightweight-server
npm install
npm start

🎯 Usage Workflow

🔗 Connect: Extension auto-connects to ws://localhost:3000
🎨 Select Tool: Choose from 14 AI tools in the popup interface
⚙️ Configure: Set parameters in the sidepanel
🚀 Execute: Run tools with real-time progress tracking
📥 Results: View, export, and manage generated outputs

🎨 Modern UI Components

🎪 Popup Interface: Quick tool access with visual grid
📱 Side Panel: Advanced parameter configuration
⚙️ Options Page: Extension settings and preferences
🔄 Real-time Updates: WebSocket-powered progress tracking
🎯 GitHub Integration: Context-aware suggestions

🔧 For Developers: MCP Server & Technical Architecture

RepoTools is built on the powerful Vibe-Coder-MCP server architecture, providing enterprise-grade AI development tools through multiple transport protocols.

🚀 Core Architecture

Multi-Transport Support

stdio: Direct MCP client integration (Claude Desktop, Cursor, Cline)
WebSocket: Real-time Chrome extension communication
HTTP: RESTful API access
SSE: Server-sent events for streaming

Advanced Features

🧠 Semantic Request Routing: Embedding-based intelligent request routing
🏗️ Tool Registry Architecture: Self-registering, modular tool system
🔄 Session State Management: Persistent context across requests
⚡ Asynchronous Execution: Job-based processing with real-time status
🛡️ Security Boundaries: Separate read/write path validation

🧠 AI-Native Task Management

Vibe Task Manager

📊 Production Ready: 99.8% test success rate
🗣️ Natural Language Processing: 6 core intents with multi-strategy recognition
🔄 Recursive Decomposition Design (RDD): Intelligent project breakdown
🤖 Agent Orchestration: Multi-agent coordination with load balancing
💾 Real Storage Integration: Zero mock code policy

Task Management Features

// Example: Task decomposition
{
  "project": "E-commerce Platform",
  "epics": 12,
  "tasks": 60,
  "subtasks": 300,
  "agents": 8,
  "completion": "real-time tracking"
}

🔍 Advanced Code Analysis

Code Map Generator

🌐 35+ Languages: Comprehensive programming language support
🎯 95-97% Token Reduction: Optimized for AI consumption
📊 Mermaid Diagrams: Visual architecture representations
🔗 Import Resolution: Third-party dependency mapping
⚡ Intelligent Caching: Configurable codemap reuse

Context Curator

🎯 Language-Agnostic: 95%+ accuracy across 35+ languages
📋 8-Phase Workflow: Comprehensive project analysis pipeline
🧠 AI-Optimized Output: 250,000 token budget with smart chunking
🔄 Multi-Format Support: XML, JSON, YAML output formats

📋 Research & Planning Suite

Research Manager

🔍 Deep Research: Perplexity Sonar integration via OpenRouter
📄 Document Generation: PRDs, user stories, task lists, development rules
🚀 Project Scaffolding: Dynamic full-stack starter kit generation
⚡ Workflow Execution: Predefined tool sequences via workflows.json

Performance Metrics

⚡ Response Time: <200ms average
💾 Memory Usage: <400MB operational
🧪 Test Coverage: 99.8% success rate (3,549+ tests)
🔒 Security: TruffleHog integration, zero secrets exposure

🛠️ Development Setup

Environment Configuration

# Core MCP Server
npm install
npm run build
npm test                    # 99.8% success rate
npm run lint               # TypeScript strict mode

# Chrome Extension
cd chrome-extension
npm install
npm run build
npm run dev                # Development with hot reload

# Lightweight Server
cd lightweight-server
npm install
npm run build
npm start                  # WebSocket server on :3000

Configuration Files

llm_config.json: LLM provider settings (OpenRouter, etc.)
mcp-config.json: MCP server configuration
workflows.json: Predefined tool execution sequences
.env: Environment variables and API keys

🔌 API Integration

MCP Protocol

// Tool execution via MCP
{
  "method": "tools/call",
  "params": {
    "name": "code-map-generator",
    "arguments": {
      "targetDirectory": "./src",
      "outputFormat": "markdown",
      "includeTests": true
    }
  }
}

WebSocket API (Chrome Extension)

// Real-time tool execution
const ws = new WebSocket('ws://localhost:3000');
ws.send(JSON.stringify({
  "tool": "vibe-task-manager",
  "params": {
    "prompt": "Create e-commerce platform",
    "complexity": "high"
  }
}));

HTTP REST API

# File operations
POST /api/files/read
POST /api/files/write

# Task management
POST /api/tasks/create
GET /api/tasks/status/:id

# System information
GET /api/system/health
GET /api/system/tools

🏗️ Architecture Patterns

Tool Registry System

// Self-registering tools
export class CodeMapGenerator implements MCPTool {
  name = 'code-map-generator';
  description = 'Generate semantic code maps';
  
  async execute(params: CodeMapParams): Promise<CodeMapResult> {
    // Implementation
  }
}

Security Architecture

🔒 Path Validation: createSecurePath() and validatePathSecurity()
📁 Directory Restrictions: Read from VIBE_TASK_MANAGER_READ_DIR
💾 Output Isolation: Write to VIBE_CODER_OUTPUT_DIR only
🛡️ Input Sanitization: All user inputs validated and sanitized

📊 Monitoring & Observability

Health Monitoring

// System health endpoint
{
  "status": "healthy",
  "uptime": "2h 34m",
  "memory": "245MB",
  "tools": 14,
  "activeJobs": 3,
  "completedJobs": 127
}

Performance Tracking

📈 Tool Execution Times: Per-tool performance metrics
💾 Memory Usage: Real-time memory monitoring
🔄 Job Queue Status: Active and completed job tracking
⚡ WebSocket Connections: Real-time connection monitoring

📚 Complete Tool Documentation

🔍 Research Tools

Research Manager

Purpose: Deep research using Perplexity Sonar via OpenRouter
Input: Research query, depth level, source preferences
Output: Comprehensive research report with citations
Use Cases: Market research, technical investigation, competitive analysis

Context Curator

Purpose: Intelligent codebase analysis with 8-phase workflow
Input: Project directory, analysis prompt, task type
Output: Curated context optimized for AI consumption
Features: Language-agnostic detection, 250K token budget, multi-format output

🏗️ Generation Tools

Code Map Generator

Purpose: Semantic codebase mapping for 35+ languages
Input: Target directory, output format, optimization level
Output: Markdown index + Mermaid diagrams
Optimization: 95-97% token reduction, importance-based filtering

Fullstack Starter Kit Generator

Purpose: Dynamic project template generation
Input: Technology stack, project requirements, architecture preferences
Output: Complete project structure with configuration
Features: 20+ technology combinations, JSON sanitization

🎯 Task Management Tools

Vibe Task Manager

Purpose: AI-powered project decomposition and agent orchestration
Input: Project description, complexity level, team size
Output: Hierarchical task breakdown with agent assignments
Features: RDD methodology, multi-agent coordination, real-time tracking

Agent Registry

Purpose: AI agent registration and task coordination
Input: Agent capabilities, availability, specializations
Output: Agent registration confirmation and task assignments
Features: Capability mapping, load balancing, performance tracking

📄 Document Generation Tools

PRD Generator

Purpose: Comprehensive Product Requirements Document creation
Input: Product concept, target audience, feature requirements
Output: Structured PRD with technical specifications
Features: Template-based generation, stakeholder analysis

User Story Generator

Purpose: Feature development user story creation
Input: Feature description, user personas, acceptance criteria
Output: Formatted user stories with acceptance criteria
Features: Persona-based generation, priority scoring

⚡ Workflow & Execution Tools

Workflow Runner

Purpose: Automated execution of predefined tool sequences
Input: Workflow name, execution parameters
Output: Workflow execution results and status
Features: Sequential execution, error handling, rollback support

Job Result Manager

Purpose: Asynchronous job monitoring and result retrieval
Input: Job ID, result format preferences
Output: Job status, progress, and final results
Features: Real-time updates, result caching, export options

🚀 Getting Started

For End Users (Chrome Extension)

Install Chrome extension from the built dist/ folder
Start local MCP server: npm start
Open extension popup and start using AI tools

For Developers (MCP Integration)

Clone repository: git clone https://github.com/freshtechbro/RepoTools.git
Install dependencies: npm install
Configure: Update llm_config.json and mcp-config.json
Run: npm start for stdio, or npm run server:ws for WebSocket

For AI Agents (API Access)

Start HTTP server: npm run server:http
Connect to WebSocket: ws://localhost:3000
Use REST API: http://localhost:3000/api/

🤝 Contributing

RepoTools is built on the solid foundation of Vibe-Coder-MCP server tools. We welcome contributions to both the Chrome extension interface and the underlying MCP server architecture.

Development Workflow

Fork repository
Create feature branch: git checkout -b feature/amazing-feature
Run tests: npm test (maintain 99.8% success rate)
Submit pull request

Architecture Guidelines

Follow existing tool registry patterns
Maintain security boundaries
Add comprehensive tests
Update documentation

📄 License

MIT License - see LICENSE file for details

🔗 Links

🌐 Official Website: https://repotools.ai
📚 Documentation: https://docs.repotools.ai
🔧 API Reference: https://api.repotools.ai
💬 Community: https://community.repotools.ai
Chrome Extension: Available in repository
MCP Server: Built on Vibe-Coder-MCP architecture
🐛 Support & Issues: https://github.com/freshtechbro/RepoTools/issues

RepoTools - Empowering developers with AI-powered tools, accessible everywhere.

Built on the robust Vibe-Coder-MCP server architecture • Chrome Extension Interface • 14 AI Tools • Enterprise Ready

🌐 Visit us at repotools.ai for the latest updates and community resources.

Author Information

freshtechbro

GitHub

Followers

Repositories

Gists

Total Contributions