Coding Task Manager

A comprehensive suite of AI-powered development tools that provides structured workflows for software development, code analysis, and project management. This toolkit includes eight specialized script collections for different aspects of development assistance.

🚀 Quick Start

1. Clone the repository:

   git clone https://github.com/kadavilrahul/coding_task_manager.git
   

   cd coding_task_manager
   

2. Root utility:

   A unified script that combines functionality from all script collections into a single executable.

   bash run.sh
   

   Interactive tool for counting and comparing total lines of code across multiple codebases.

   bash compare.sh
   

3. Choose your script collection:

   # For AI-powered PRD generation
   cd ai_powered_development
   
   # For basic coding assistance
   cd basic_coding_assistant
   
   # For advanced analysis tools
   cd advanced_coding_assistant
   
   # For file versioning and backup
   cd file_versioning_system
   
   # For flowchart generation
   cd flowchart_generator
   
   # For remote Linux operations
   cd remote_linux_tools
   
   # For Node.js MCP servers
   cd nodejs_mcp
   

4. Follow the specific setup instructions for your chosen collection below.

Root Utility Scripts

The repository includes two utility scripts in the root directory for quick access:

run.sh - Comprehensive Shell Script Runner

A unified script that combines functionality from all script collections into a single executable.

Features:

• Project Analysis: Generate comprehensive project information and structure
• Code Metrics: CLOC integration for detailed line counting
• Function Discovery: Multiple methods (grep, ctags, AST) for function extraction
• File Monitoring: Real-time file versioning and backup capabilities
• Quality Tools: Linting, validation, and code quality checks
• Interactive & CLI Modes: Flexible usage options

Usage:

# Run interactively
./run.sh

# Or use specific functions directly
./run.sh generate_project_info
./run.sh install_and_run_cloc
./run.sh collect_functions_interactive

compare.sh - Codebase Line Counter & Comparator

Interactive tool for counting and comparing total lines of code across multiple codebases.

Features:

• Multi-Codebase Analysis: Compare line counts across different projects
• Interactive Interface: User-friendly prompts for folder selection
• Automated Reporting: Results saved to codebase_line_counts.txt
• Error Handling: Validates paths and handles missing directories

Usage:

./compare.sh
# Follow prompts to enter codebase paths
# Type 'quit' or 'q' to finish and generate report

🚀 Overview

The Coding Task Manager consists of eight main components:

• AI-Powered Development: AI-powered PRD generation and development SOPs
• Basic Coding Assistant: Basic coding assistant with function extraction tools
• Advanced Coding Assistant: Advanced coding assistant with comprehensive analysis and reporting
• File Versioning System: File versioning system with real-time backup monitoring
• Flowchart Generator: Streamlined flowchart generation in HTML and PNG formats
• Remote Linux Tools: Automated remote Linux server login and command execution
• Docker MCP: Model Context Protocol server setup with Docker for browser automation
• Node.js MCP: Production-ready MCP servers for e-commerce and AI agent businesses

📋 Table of Contents

• ✨ Features
• 🚀 Quick Start
• 🛠️ Root Utility Scripts
• 📁 Script Collections
  • AI-Powered Development Tools
  • Basic Coding Assistant
  • Advanced Coding Assistant
  • File Versioning System
  • Flowchart Generator
  • Remote Linux Tools
  • Docker MCP
  • Node.js MCP
• 🛠️ Utilities
• 💻 Installation
• 📚 Usage Examples
• ⚙️ Configuration
• 🔧 Troubleshooting
• 🤝 Contributing
• 📄 License
• 📊 Project Statistics
• 🔗 Related Projects
• 🚦 Status

✨ Features

🤖 AI-Powered Development

• PRD Generation: Create detailed Product Requirements Documents using Gemini/Claude AI
• Standard Operating Procedures: JSON-based SOPs for AI-assisted development
• MCP Integration: Model Context Protocol setup for GitHub Copilot and Cline
• Code Generation Guidelines: Structured prompts for consistent code quality

📊 Code Analysis & Metrics

• Line Counting: Comprehensive code metrics with CLOC integration
• Function Extraction: Multiple methods (grep, ctags, AST) for function discovery
• Pattern Search: Fast text search with RipGrep/grep fallback
• Quality Linting: ShellCheck, JSON validation, and code quality checks

🔍 Project Intelligence

• Structure Analysis: Automated project structure generation
• Sensitive Data Scanning: Security-focused content analysis
• Git Statistics: Repository metrics and contributor analysis
• Comprehensive Reporting: Markdown reports with timestamped outputs

🔄 File Management & Backup

• Real-time Monitoring: Automatic file change detection with inotify
• Timestamped Backups: Automatic backup creation on file modifications
• Smart Filtering: Configurable ignore patterns for selective monitoring
• Background Operation: Non-intrusive process management with PID tracking

---

📁 Script Collections

AI-Powered Development Tools

Purpose: AI-powered PRD generation, development SOPs, and MCP integration for enhanced coding workflows.

🛠️ Tools Included

• 00_generate_prd.py - Multi-model PRD generator (Gemini/Claude)
• 00_generate_code_using_sop.json - Comprehensive development SOP
• 00_generate_run_script.json - Run script generation prompts
• 00_generate_project_info.sh - Project structure and analysis
• 00_generate_mcp.md - MCP setup for GitHub Copilot/Cline

📦 Installation

cd ai_powered_development
python3 -m venv venv
source venv/bin/activate  # On Linux/macOS
# venv\Scripts\activate  # On Windows
pip install -r requirements.txt

⚙️ Configuration

Create a .env file:

GEMINI_API_KEY=your_gemini_api_key_here
ANTHROPIC_API_KEY=your_claude_api_key_here  # Optional

🚀 Usage

# Generate project information
bash 00_generate_project_info.sh

# Generate PRD with AI
python 00_generate_prd.py

# Follow MCP setup instructions
cat 00_generate_mcp.md

---

Basic Coding Assistant

Purpose: Essential coding assistance with function extraction and basic code analysis tools.

🛠️ Tools Included

• extract_functions.py - Python AST-based function extraction
• collect_functions.sh - Multi-method function collection (grep/ctags/AST)
• run_cloc.sh - Automated CLOC installation and execution
• sop.json - Basic coding assistant guidelines

📦 Installation

cd basic_coding_assistant
# Optional: Create virtual environment for Python scripts
python3 -m venv venv
source venv/bin/activate

🚀 Usage

# Extract functions using different methods
bash collect_functions.sh

# Run code analysis
bash run_cloc.sh

# Extract Python functions specifically
python extract_functions.py

---

Advanced Coding Assistant

Purpose: Professional-grade coding assistance with comprehensive analysis, reporting, and quality tools.

🛠️ Tools Included

• coding_assistant_tools.sh - Multi-functional analysis toolkit
• sop.json - Advanced coding assistant guidelines

📦 Features

• Code Metrics: CLOC integration for detailed statistics
• Pattern Search: RipGrep/grep with fallback support
• Quality Checks: ShellCheck, JSON validation
• Git Analysis: Repository statistics and history
• Report Generation: Timestamped Markdown reports
• Interactive & CLI Modes: Flexible usage options

🚀 Usage

Interactive Mode:

cd advanced_coding_assistant
./coding_assistant_tools.sh

Command Line Mode:

# Count lines of code
./coding_assistant_tools.sh cloc

# Search for patterns
./coding_assistant_tools.sh search "TODO"

# Generate comprehensive report
./coding_assistant_tools.sh report

# Lint shell scripts
./coding_assistant_tools.sh lint-sh

---

File Versioning System

Purpose: Lightweight file versioning system with real-time monitoring and automatic backup creation using Linux inotify.

🛠️ Tools Included

• file_versioning.sh - Main monitoring script with inotify integration
• check_versioning.sh - Status checker and process management
• setup_file_versioning.sh - Automated setup and configuration

📦 Features

• Real-time Monitoring: Uses Linux inotify for instant file change detection
• Automatic Backups: Creates timestamped backups on file modifications
• Smart Filtering: .versioningignore file for excluding unwanted files
• Process Management: PID tracking for easy start/stop operations
• Background Operation: Non-intrusive monitoring with log output
• AI-Editor Friendly: Perfect for use with AI-based code editors

📋 Prerequisites

# Ubuntu/Debian
sudo apt-get install inotify-tools

# CentOS/RHEL
sudo yum install inotify-tools

🚀 Usage

Quick Setup:

cd file_versioning_system
# Copy scripts to your target directory
cp {setup_file_versioning.sh,file_versioning.sh,check_versioning.sh} /path/to/your/project/
cd /path/to/your/project/

# Run setup and start monitoring
bash setup_file_versioning.sh
nohup bash file_versioning.sh > file_versioning.log 2>&1 &

Management Commands:

# Check status
bash check_versioning.sh

# Stop monitoring
pkill -f file_versioning.sh

📁 File Organization

• backups/ - Timestamped backup files (auto-created)
• .versioningignore - Ignore patterns configuration
• .file_versioning.pid - Process ID for management
• file_versioning.log - Monitoring activity log

---

Flowchart Generator

Purpose: Streamlined flowchart generation in HTML and PNG formats for AI workflows and documentation.

🛠️ Tools Included

• setup_flowchart.sh - Automated setup and dependency installation
• generate.sh - Flowchart generation script

📦 Features

• Command line based flowchart generation environment
• Automated dependency management and setup
• HTML and PNG output formats
• Easy-to-use command line interface
• Automatic environment configuration

🚀 Usage

First time setup:

cd flowchart_generator
bash setup_flowchart.sh

Subsequent runs:

bash generate.sh

🔧 System Requirements

• Linux system with GUI (GUI needed to view files)
• Tested on Ubuntu 24.04 LTS

---

Remote Linux Tools

Purpose: Automated remote Linux server login and command execution for distributed development workflows.

🛠️ Tools Included

• main.sh - Main automation script for remote command execution
• test_login_manually.sh - Interactive login testing script
• test_run_commands_with_manual_login.sh - Combined login and command execution test

📦 Features

• Secure SSH Authentication: Multiple authentication methods supported
• Automated Command Execution: Execute commands on remote servers automatically
• Configurable Settings: Easy-to-configure remote server parameters
• Error Handling: Robust error handling and validation
• Interactive Testing: Manual testing capabilities for debugging
• Batch Operations: Support for running multiple commands

🚀 Usage

Configuration:

cd remote_linux_tools
# Edit main.sh to configure:
DEFAULT_USER="your_username"
DEFAULT_PORT="22"
DEFAULT_IP="remote_server_ip"
DEFAULT_PASS="your_password"  # Use SSH keys instead

Automated Execution:

bash main.sh

Interactive Testing:

bash test_login_manually.sh
bash test_run_commands_with_manual_login.sh

---

Docker MCP

Purpose: Model Context Protocol server setup with Docker for browser automation and AI-powered web interactions.

🛠️ Tools Included

• Dockerfile - Custom MCP Puppeteer server image
• docker-compose.yml - Docker Compose configuration for service management
• setup.sh - Automated setup and deployment script
• configs/claude-config.json - Claude Desktop integration configuration
• configs/mcp-puppeteer-server.json - Basic MCP server configuration

📦 Features

• Browser Automation: Puppeteer-based web automation through MCP protocol
• Docker Integration: Containerized deployment with official and custom images
• Claude Desktop Support: Ready-to-use configurations for AI integration
• Screenshot Capture: Automated screenshot functionality with volume mounting
• Headless Operation: Chromium-based headless browser automation
• Security Features: Digitally signed images with Software Bill of Materials (SBOM)

📋 Prerequisites

# Docker and Docker Compose
sudo apt-get update
sudo apt-get install docker.io docker-compose
sudo systemctl start docker
sudo systemctl enable docker

# Add user to docker group (optional)
sudo usermod -aG docker $USER

🚀 Usage

Quick Start:

cd docker_mcp
# Make setup script executable
chmod +x scripts/setup.sh
# Run automated setup
./scripts/setup.sh

Manual Setup:

# Pull official image
docker pull mcp/puppeteer:latest

# Create screenshots directory
mkdir -p screenshots

# Run with Docker Compose
docker-compose up -d

# Or run directly
docker run -i --rm --init -e DOCKER_CONTAINER=true mcp/puppeteer

⚙️ Configuration

Claude Desktop Integration: Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "puppeteer": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--init",
        "-e", "DOCKER_CONTAINER=true",
        "mcp/puppeteer"
      ]
    }
  }
}

Available MCP Tools:

• navigate_to_url - Navigate to specific URLs
• screenshot - Capture webpage screenshots
• click_element - Interact with webpage elements
• execute_javascript - Run custom JavaScript
• fill_form - Fill out web forms
• wait_for_element - Wait for elements to appear

🔧 Management Commands

# Check running containers
docker ps | grep puppeteer

# View logs
docker logs mcp-puppeteer-server

# Stop services
docker-compose down

# Update images
docker pull mcp/puppeteer:latest
docker-compose restart

---

Node.js MCP

Purpose: Production-ready Model Context Protocol servers optimized for e-commerce businesses and AI agent services.

🛠️ Tools Included

• Screenshot MCP Server - Custom Node.js implementation for webpage screenshots
• Context7 MCP Server - Real-time documentation injection
• IDE Server Integration - Built-in development environment support
• Installation Scripts - Automated setup for production deployment
• Comprehensive Documentation - Business-specific guides and troubleshooting

📦 Features

• E-commerce Focused: Optimized for businesses with 120,000+ products
• Production Ready: Tested and reliable MCP servers
• Business Intelligence: Perfect for AI agent services
• WordPress/WooCommerce: Specialized tools for e-commerce platforms
• Server Management: Ideal for Hetzner/Ubuntu LAMP stack environments
• Indian Market: Considerations for Kerala-based e-commerce operations

🚀 Active MCP Servers

1. Screenshot Server (mcp__screenshot-server__)

• Take screenshots of webpages for monitoring
• Capture competitor site changes
• Visual documentation for clients
• Custom Node.js implementation using headless Chrome

2. Context7 Server (mcp__context7__)

• Get current, version-specific documentation
• Eliminate outdated API examples
• Perfect for WordPress/WooCommerce development
• Supports all major frameworks and libraries

3. IDE Server (mcp__ide__)

• Language diagnostics from VS Code
• Execute Python code in Jupyter kernel
• Code analysis and debugging support
• Built-in Claude Code functionality

📦 Installation

Quick Setup:

cd nodejs_mcp
# Install working MCP servers only
./install-working-mcps.sh

Manual Installation:

# Add Context7 MCP Server
claude mcp add context7 "npx @upstash/context7-mcp"

# Add Screenshot MCP Server
claude mcp add screenshot-server "/root/screenshot-mcp-server.js"

# Verify installation
claude mcp list

📋 Prerequisites

• Node.js (v20.0.0 or higher)
• Claude Code CLI
• Chromium browser (for screenshots)
• npm/npx (for Context7)

💼 Business Use Cases

E-commerce Operations:

• Monitor nilgiristores.in and silkroademart.com visually
• Screenshot competitor pricing and inventory
• Get current WooCommerce/WordPress documentation
• Analyze business data with Python/Jupyter

AI Agent Services:

• Client website screenshots for reports
• Current library documentation for development
• Code diagnostics and quality assurance
• Professional development environment

Server Management:

• Visual monitoring of Hetzner server dashboards
• Current API documentation for integrations
• Development tools for server-side applications
• Screenshot-based change verification

🔧 Configuration

Screenshot Server Setup:

# Custom Node.js implementation
chmod +x screenshot-mcp-server.js
node screenshot-mcp-server.js --help

Context7 Configuration:

# Uses Upstash service for real-time documentation
npx @upstash/context7-mcp --help

📊 Usage Examples

Screenshot Operations:

Take a screenshot of https://nilgiristores.in
Screenshot competitor site https://example.com
Capture the WordPress admin dashboard

Documentation Lookup:

use context7 - show me WooCommerce REST API documentation
use context7 - get current WordPress plugin development guide
use context7 - find React hooks best practices

Development Support:

Get diagnostics for this JavaScript file
Execute this Python code in Jupyter
Analyze this WooCommerce plugin code

🌍 India-Specific Benefits

Kerala E-commerce Focus:

• Monitor Indian marketplace competitors
• Get INR-specific payment gateway documentation
• Screenshot regional website changes
• Support for multilingual e-commerce sites

Local Business Intelligence:

• Analyze Kerala market trends with Python
• Monitor spice industry competitors
• Tourism website screenshot monitoring
• Local supplier website tracking

🔍 Troubleshooting

Common Issues:

• Connection timeouts: Check network connectivity
• Context7 limits: Monitor API usage quotas
• Screenshot failures: Verify Chromium installation
• IDE connectivity: Restart Claude Code if needed

Debug Commands:

# Check MCP server status
claude mcp list

# Enable debug logging
claude --debug mcp list

# Test screenshot server
node screenshot-mcp-server.js --help

📚 Documentation Structure

nodejs_mcp/
├── MCP-SERVERS-OVERVIEW.md          # Complete business overview
├── install-working-mcps.sh          # Production installation script
├── context7-mcp-server/             # Context7 documentation
│   ├── README.md
│   ├── context7-install.md
│   └── mcp-commands.sh
└── screenshot-mcp-server/           # Screenshot server files
    ├── README.md
    ├── screenshot-mcp-server.js
    ├── package.json
    └── install.sh

🛡️ Security & Reliability

Production Features:

• Only working, tested MCP servers
• Secure screenshot capture (no system access)
• Read-only documentation access
• Controlled Python/Jupyter environment
• No persistent storage of sensitive data

Business Reliability:

• Custom Node.js implementation for screenshots
• Official Upstash Context7 server
• Built-in Claude Code IDE functionality
• Comprehensive error handling and logging

---

🛠️ Utilities

The utilities/ directory contains core tools that support all script collections:

Tools Included

• github_repository_cloner.sh - Interactive GitHub repository cloning with API integration
• project_analyzer.sh - Comprehensive project analysis and reporting
• codebase_comparator.sh - Multi-codebase line count comparison
• config.json - Configuration file for GitHub operations

Usage

cd utilities
bash github_repository_cloner.sh    # Clone GitHub repositories
bash project_analyzer.sh            # Analyze projects
bash codebase_comparator.sh         # Compare codebases

---

💻 Installation

Prerequisites

• Python 3.8+ (for AI-Powered Development & Basic Coding Assistant)
• Bash shell (Linux/macOS/WSL)
• Git (for repository operations)
• inotify-tools (for File Versioning System - Linux only)

Optional Dependencies

The tools gracefully handle missing dependencies:

• cloc - Code line counting
• ripgrep (rg) - Fast pattern searching
• tree - Directory visualization
• shellcheck - Shell script linting
• jq - JSON processing
• ctags - Code indexing
• inotify-tools - Real-time file monitoring (required for Scripts 04)

API Keys (AI-Powered Development only)

• Gemini API Key: Required for Google's Gemini models
• Anthropic API Key: Optional for Claude models

📚 Usage Examples

Generate a Complete Project Analysis

# Using AI-Powered Development
cd ai_powered_development
bash 00_generate_project_info.sh
python 00_generate_prd.py

# Using Advanced Coding Assistant for detailed analysis
cd ../advanced_coding_assistant
./coding_assistant_tools.sh report

Code Quality Workflow

cd advanced_coding_assistant

# Check shell scripts
./coding_assistant_tools.sh lint-sh

# Validate JSON files
./coding_assistant_tools.sh lint-json

# Search for TODOs and FIXMEs
./coding_assistant_tools.sh search "TODO|FIXME"

Function Discovery Workflow

cd basic_coding_assistant

# Interactive method selection
bash collect_functions.sh

# Direct Python AST extraction
python extract_functions.py

⚙️ Configuration

Environment Variables (AI-Powered Development)

# Required for AI features
GEMINI_API_KEY=your_key_here

# Optional for Claude support
ANTHROPIC_API_KEY=your_key_here

Tool Preferences (Advanced Coding Assistant)

The advanced tools automatically detect and prefer:

• ripgrep over grep for searching
• tree over find for directory listing
• Native tools when specialized ones aren't available

🔧 Troubleshooting

Common Issues

AI-Powered Development

• ValueError: Missing GEMINI_API_KEY: Create .env file with valid API key
• ModuleNotFoundError: Activate virtual environment and run pip install -r requirements.txt
• google-genai errors: Ensure pip install google-genai completed successfully

Basic & Advanced Coding Assistant

• Permission denied: Make scripts executable with chmod +x *.sh
• Command not found: Install missing dependencies or use fallback options
• No functions found: Ensure you're in a directory with code files

Tool Installation

Ubuntu/Debian

sudo apt update
sudo apt install cloc ripgrep tree shellcheck jq exuberant-ctags inotify-tools

macOS (with Homebrew)

brew install cloc ripgrep tree shellcheck jq ctags
# Note: inotify-tools not available on macOS (File Versioning System requires Linux)

Windows (WSL recommended)

Use WSL with Ubuntu and follow the Ubuntu installation steps.

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Development Guidelines

• Follow the 150-line modularity constraint from AI-Powered Development SOP
• Add comprehensive error handling
• Include usage examples in documentation
• Test on multiple platforms when possible

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

📊 Project Statistics

# Get project overview
find . -name "*.py" -o -name "*.sh" -o -name "*.json" -o -name "*.md" | wc -l
# Expected: ~15+ files across all script collections

# Check script collections
ls -la */

🔗 Related Projects

• GitHub Copilot - AI pair programmer
• Cline - AI coding assistant
• CLOC - Count Lines of Code
• RipGrep - Fast text search

🚦 Status

• ✅ AI-Powered Development: Stable - AI-powered PRD generation working
• ✅ Basic Coding Assistant: Stable - Basic coding assistance tools functional
• ✅ Advanced Coding Assistant: Stable - Advanced analysis tools with comprehensive reporting
• ✅ File Versioning System: Stable - File versioning system with real-time monitoring
• ✅ Flowchart Generator: Stable - Flowchart generation in HTML and PNG formats
• ✅ Remote Linux Tools: Stable - Remote SSH automation and command execution
• ✅ Docker MCP: Stable - Model Context Protocol server with Docker for browser automation
• ✅ Node.js MCP: Production Ready - Working MCP servers for e-commerce and AI agent businesses
• ✅ Utilities: Stable - Core utility tools for project management
• 🔄 Continuous improvements and feature additions

🙏 Acknowledgments

• Google Gemini API for AI-powered PRD generation
• Anthropic Claude for additional AI model support
• The open-source community for the excellent tools integrated into this project
• Contributors who help improve and maintain this toolkit

---

Made with ❤️ for developers who want to enhance their coding workflow with AI assistance and comprehensive analysis tools.