@fyow/copilot-everything 1.0.0

package/README.md

@@ -0,0 +1,185 @@
+# copilot-everything
+
+[![npm version](https://img.shields.io/npm/v/copilot-everything.svg)](https://www.npmjs.com/package/copilot-everything)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+![Node.js](https://img.shields.io/badge/-Node.js-339933?logo=node.js&logoColor=white)
+![TypeScript](https://img.shields.io/badge/-TypeScript-3178C6?logo=typescript&logoColor=white)
+
+**Everything you need for GitHub Copilot CLI** - agents, skills, instructions, and hooks configurations.
+
+Production-ready configurations evolved from 10+ months of intensive daily use building real products.
+
+---
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g copilot-everything
+
+# Initialize in your project
+cd your-project
+copilot-everything init --ai copilot
+
+# Start using with Copilot CLI
+copilot
+/agent planner
+```
+
+---
+
+## What's Included
+
+### 🤖 Custom Agents (9)
+
+| Agent | Purpose | Invoke |
+|-------|---------|--------|
+| planner | Implementation planning | /agent planner |
+| architect | System design decisions | /agent architect |
+| tdd-guide | Test-driven development | /agent tdd-guide |
+| code-reviewer | Code quality review | /agent code-reviewer |
+| security-reviewer | Security analysis | /agent security-reviewer |
+| build-error-resolver | Fix build/type errors | /agent build-error-resolver |
+| e2e-runner | Playwright E2E testing | /agent e2e-runner |
+| refactor-cleaner | Dead code cleanup | /agent refactor-cleaner |
+| doc-updater | Documentation sync | /agent doc-updater |
+
+### 📚 Skills (8)
+
+| Skill | Description |
+|-------|-------------|
+| backend-patterns | Backend architecture, API design, database patterns |
+| clickhouse-io | ClickHouse analytics patterns and optimization |
+| coding-standards | Universal coding standards and best practices |
+| frontend-patterns | React, Next.js, state management patterns |
+| project-guidelines-example | Example project-specific skill template |
+| security-review | Security checklist and vulnerability patterns |
+| tdd-workflow | Test-driven development workflow |
+| verification-loop | Code verification and quality gates |
+
+### 📝 Instructions (5)
+
+Path-specific coding guidelines automatically applied:
+
+- coding-style.instructions.md - For **/*.ts,**/*.tsx,**/*.js,**/*.jsx
+- security.instructions.md - For code files
+- testing.instructions.md - For test files
+- git-workflow.instructions.md - For all files
+- performance.instructions.md - For all files
+
+### 🪝 Hooks
+
+Pre-configured hooks for sessionStart, sessionEnd, preToolUse, postToolUse.
+
+---
+
+## CLI Usage
+
+```bash
+copilot-everything <command> [options]
+```
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| init | Initialize Copilot configurations in current directory |
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| --ai type | Target AI platform: copilot (default), claude, or all |
+| --force | Overwrite existing files |
+| --skip-agents | Skip agent installation |
+| --skip-skills | Skip skills installation |
+| --skip-hooks | Skip hooks installation |
+| -h, --help | Show help message |
+| -v, --version | Show version number |
+
+### Examples
+
+```bash
+# Initialize with Copilot CLI configs
+copilot-everything init
+
+# Initialize with force overwrite
+copilot-everything init --force
+
+# Skip certain components
+copilot-everything init --skip-hooks --skip-skills
+
+# Initialize for both Copilot and Claude
+copilot-everything init --ai all
+```
+
+---
+
+## Installed Structure
+
+After running copilot-everything init, your project will have:
+
+```
+your-project/
+├── AGENTS.md                           # Top-level agent instructions
+└── .github/
+    ├── copilot-instructions.md         # Repository-wide instructions
+    ├── agents/
+    │   ├── planner.agent.md
+    │   ├── architect.agent.md
+    │   └── ... (9 agents)
+    ├── instructions/
+    │   ├── coding-style.instructions.md
+    │   ├── security.instructions.md
+    │   └── ... (5 instructions)
+    ├── skills/
+    │   ├── backend-patterns/SKILL.md
+    │   ├── coding-standards/SKILL.md
+    │   └── ... (8 skills)
+    └── hooks/
+        └── project-hooks.json
+```
+
+---
+
+## Compatibility
+
+- **GitHub Copilot CLI** ✅
+- **Claude Code** ✅ (uses same .github/ structure)
+- **VS Code Copilot** ✅
+- **Node.js** >= 18.0.0
+
+---
+
+## Customization
+
+After installation, customize the configs for your project:
+
+1. **Edit copilot-instructions.md** - Add project-specific context
+2. **Modify agents** - Adjust agent prompts for your workflow
+3. **Add skills** - Create new skills in .github/skills/your-skill/SKILL.md
+4. **Update instructions** - Add path-specific rules in .github/instructions/
+
+---
+
+## Migration from Claude Code
+
+See [MIGRATION-GUIDE.md](docs/MIGRATION-GUIDE.md) for detailed migration instructions.
+
+---
+
+## Contributing
+
+Contributions welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) first.
+
+---
+
+## License
+
+MIT
+
+---
+
+## Credits
+
+Based on the "Everything Claude Code" configurations by [@affaanmustafa](https://github.com/affaan-m).

package/copilot/config.json

@@ -0,0 +1,5 @@
+{
+  "trusted_folders": [],
+  "model": "claude-sonnet-4-5",
+  "theme": "dark"
+}

package/copilot/mcp-config.json

@@ -0,0 +1,42 @@
+{
+  "servers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
+      }
+    },
+    "memory": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-memory"]
+    },
+    "sequential-thinking": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
+    },
+    "firecrawl": {
+      "command": "npx",
+      "args": ["-y", "firecrawl-mcp"],
+      "env": {
+        "FIRECRAWL_API_KEY": "${FIRECRAWL_API_KEY}"
+      }
+    },
+    "supabase": {
+      "command": "npx",
+      "args": ["-y", "@supabase/mcp-server-supabase@latest", "--project-ref=${SUPABASE_PROJECT_REF}"]
+    },
+    "vercel": {
+      "type": "http",
+      "url": "https://mcp.vercel.com"
+    },
+    "railway": {
+      "command": "npx",
+      "args": ["-y", "@railway/mcp-server"]
+    },
+    "cloudflare-docs": {
+      "type": "http",
+      "url": "https://docs.mcp.cloudflare.com/mcp"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@fyow/copilot-everything",
+  "version": "1.0.0",
+  "description": "Everything you need for GitHub Copilot CLI - agents, skills, instructions, and hooks configurations",
+  "main": "src/index.js",
+  "bin": {
+    "copilot-everything": "src/cli.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src/",
+    ".github/",
+    "AGENTS.md",
+    "copilot/"
+  ],
+  "scripts": {
+    "test": "node tests/run-all.js",
+    "lint": "echo 'No linter configured'"
+  },
+  "keywords": [
+    "copilot",
+    "github-copilot",
+    "copilot-cli",
+    "ai",
+    "coding-agent",
+    "agents",
+    "skills",
+    "instructions",
+    "mcp",
+    "hooks"
+  ],
+  "author": "fyow",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fyow/copilot-everything.git"
+  },
+  "bugs": {
+    "url": "https://github.com/fyow/copilot-everything/issues"
+  },
+  "homepage": "https://github.com/fyow/copilot-everything#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/cli.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+
+/**
+ * copilot-everything CLI
+ * Install GitHub Copilot CLI configurations (agents, skills, instructions, hooks)
+ */
+
+const { init } = require('./commands/init');
+const { version } = require('../package.json');
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+// Parse flags
+const flags = {};
+args.forEach((arg, index) => {
+  if (arg.startsWith('--')) {
+    const key = arg.slice(2);
+    const value = args[index + 1] && !args[index + 1].startsWith('-') ? args[index + 1] : true;
+    flags[key] = value;
+  } else if (arg.startsWith('-') && arg.length === 2) {
+    const key = arg.slice(1);
+    const value = args[index + 1] && !args[index + 1].startsWith('-') ? args[index + 1] : true;
+    flags[key] = value;
+  }
+});
+
+// Help text
+const helpText = `
+copilot-everything v${version}
+
+Everything you need for GitHub Copilot CLI - agents, skills, instructions, and hooks.
+
+Usage:
+  copilot-everything <command> [options]
+
+Commands:
+  init          Initialize Copilot configurations in current directory
+
+Options:
+  --ai <type>   Target AI platform: copilot (default), claude, or all
+  --force       Overwrite existing files
+  --skip-agents Skip agent installation
+  --skip-skills Skip skills installation
+  --skip-hooks  Skip hooks installation
+  -h, --help    Show this help message
+  -v, --version Show version number
+
+Examples:
+  copilot-everything init
+  copilot-everything init --ai copilot
+  copilot-everything init --ai claude
+  copilot-everything init --ai all --force
+
+Learn more: https://github.com/fyow/copilot-everything
+`;
+
+// Version
+if (flags.v || flags.version) {
+  console.log(version);
+  process.exit(0);
+}
+
+// Help
+if (flags.h || flags.help || !command) {
+  console.log(helpText);
+  process.exit(0);
+}
+
+// Execute command
+switch (command) {
+  case 'init':
+    init(flags);
+    break;
+  default:
+    console.error(`Unknown command: ${command}`);
+    console.log(helpText);
+    process.exit(1);
+}

package/src/commands/init.js

@@ -0,0 +1,212 @@
+/**
+ * init command - Install Copilot configurations to current directory
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Get package root directory (where .github folder lives)
+const PACKAGE_ROOT = path.resolve(__dirname, '..', '..');
+
+/**
+ * Recursively copy directory
+ */
+function copyDir(src, dest, options = {}) {
+  const { force = false, dryRun = false } = options;
+  
+  if (!fs.existsSync(src)) {
+    return { copied: 0, skipped: 0, errors: [] };
+  }
+
+  let result = { copied: 0, skipped: 0, errors: [] };
+
+  if (!dryRun && !fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      const subResult = copyDir(srcPath, destPath, options);
+      result.copied += subResult.copied;
+      result.skipped += subResult.skipped;
+      result.errors.push(...subResult.errors);
+    } else {
+      try {
+        if (fs.existsSync(destPath) && !force) {
+          result.skipped++;
+        } else {
+          if (!dryRun) {
+            fs.copyFileSync(srcPath, destPath);
+          }
+          result.copied++;
+        }
+      } catch (error) {
+        result.errors.push({ path: destPath, error: error.message });
+      }
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Copy single file
+ */
+function copyFile(src, dest, options = {}) {
+  const { force = false, dryRun = false } = options;
+
+  if (!fs.existsSync(src)) {
+    return { copied: 0, skipped: 0, errors: [{ path: dest, error: 'Source not found' }] };
+  }
+
+  if (fs.existsSync(dest) && !force) {
+    return { copied: 0, skipped: 1, errors: [] };
+  }
+
+  try {
+    if (!dryRun) {
+      const destDir = path.dirname(dest);
+      if (!fs.existsSync(destDir)) {
+        fs.mkdirSync(destDir, { recursive: true });
+      }
+      fs.copyFileSync(src, dest);
+    }
+    return { copied: 1, skipped: 0, errors: [] };
+  } catch (error) {
+    return { copied: 0, skipped: 0, errors: [{ path: dest, error: error.message }] };
+  }
+}
+
+/**
+ * Main init function
+ */
+function init(flags = {}) {
+  const targetDir = process.cwd();
+  const aiType = flags.ai || 'copilot';
+  const force = flags.force || false;
+  const skipAgents = flags['skip-agents'] || false;
+  const skipSkills = flags['skip-skills'] || false;
+  const skipHooks = flags['skip-hooks'] || false;
+
+  console.log('');
+  console.log('🚀 copilot-everything init');
+  console.log('');
+  console.log(`📁 Target directory: ${targetDir}`);
+  console.log(`🤖 AI platform: ${aiType}`);
+  console.log(`⚡ Force overwrite: ${force ? 'yes' : 'no'}`);
+  console.log('');
+
+  const options = { force };
+  let totalCopied = 0;
+  let totalSkipped = 0;
+  let totalErrors = [];
+
+  // Determine what to install based on AI type
+  const installGithub = aiType === 'copilot' || aiType === 'all';
+  const installClaude = aiType === 'claude' || aiType === 'all';
+
+  // Install .github directory (for Copilot CLI)
+  if (installGithub) {
+    console.log('📦 Installing Copilot CLI configurations...');
+
+    // Copy .github directory structure
+    const githubSrc = path.join(PACKAGE_ROOT, '.github');
+    const githubDest = path.join(targetDir, '.github');
+
+    // Agents
+    if (!skipAgents) {
+      const agentsSrc = path.join(githubSrc, 'agents');
+      const agentsDest = path.join(githubDest, 'agents');
+      const result = copyDir(agentsSrc, agentsDest, options);
+      console.log(`   ✅ Agents: ${result.copied} copied, ${result.skipped} skipped`);
+      totalCopied += result.copied;
+      totalSkipped += result.skipped;
+      totalErrors.push(...result.errors);
+    }
+
+    // Skills
+    if (!skipSkills) {
+      const skillsSrc = path.join(githubSrc, 'skills');
+      const skillsDest = path.join(githubDest, 'skills');
+      const result = copyDir(skillsSrc, skillsDest, options);
+      console.log(`   ✅ Skills: ${result.copied} copied, ${result.skipped} skipped`);
+      totalCopied += result.copied;
+      totalSkipped += result.skipped;
+      totalErrors.push(...result.errors);
+    }
+
+    // Instructions
+    const instructionsSrc = path.join(githubSrc, 'instructions');
+    const instructionsDest = path.join(githubDest, 'instructions');
+    const instructionsResult = copyDir(instructionsSrc, instructionsDest, options);
+    console.log(`   ✅ Instructions: ${instructionsResult.copied} copied, ${instructionsResult.skipped} skipped`);
+    totalCopied += instructionsResult.copied;
+    totalSkipped += instructionsResult.skipped;
+    totalErrors.push(...instructionsResult.errors);
+
+    // Hooks
+    if (!skipHooks) {
+      const hooksSrc = path.join(githubSrc, 'hooks');
+      const hooksDest = path.join(githubDest, 'hooks');
+      const result = copyDir(hooksSrc, hooksDest, options);
+      console.log(`   ✅ Hooks: ${result.copied} copied, ${result.skipped} skipped`);
+      totalCopied += result.copied;
+      totalSkipped += result.skipped;
+      totalErrors.push(...result.errors);
+    }
+
+    // copilot-instructions.md
+    const copilotInstructionsSrc = path.join(githubSrc, 'copilot-instructions.md');
+    const copilotInstructionsDest = path.join(githubDest, 'copilot-instructions.md');
+    const copilotResult = copyFile(copilotInstructionsSrc, copilotInstructionsDest, options);
+    console.log(`   ✅ copilot-instructions.md: ${copilotResult.copied} copied, ${copilotResult.skipped} skipped`);
+    totalCopied += copilotResult.copied;
+    totalSkipped += copilotResult.skipped;
+    totalErrors.push(...copilotResult.errors);
+
+    // AGENTS.md at root
+    const agentsMdSrc = path.join(PACKAGE_ROOT, 'AGENTS.md');
+    const agentsMdDest = path.join(targetDir, 'AGENTS.md');
+    const agentsMdResult = copyFile(agentsMdSrc, agentsMdDest, options);
+    console.log(`   ✅ AGENTS.md: ${agentsMdResult.copied} copied, ${agentsMdResult.skipped} skipped`);
+    totalCopied += agentsMdResult.copied;
+    totalSkipped += agentsMdResult.skipped;
+    totalErrors.push(...agentsMdResult.errors);
+  }
+
+  // Install Claude Code configurations (for backwards compatibility)
+  if (installClaude) {
+    console.log('📦 Installing Claude Code configurations...');
+    console.log('   ⚠️  Claude Code support uses the same .github structure');
+    console.log('   ⚠️  Claude Code also reads from .github/skills/ and .github/agents/');
+  }
+
+  // Summary
+  console.log('');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log(`✨ Installation complete!`);
+  console.log(`   📁 Files copied: ${totalCopied}`);
+  console.log(`   ⏭️  Files skipped: ${totalSkipped}`);
+  
+  if (totalErrors.length > 0) {
+    console.log(`   ❌ Errors: ${totalErrors.length}`);
+    totalErrors.forEach(e => console.log(`      - ${e.path}: ${e.error}`));
+  }
+
+  console.log('');
+  console.log('📖 Next steps:');
+  console.log('   1. Review and customize .github/copilot-instructions.md');
+  console.log('   2. Start Copilot CLI: copilot');
+  console.log('   3. Use custom agents: /agent planner');
+  console.log('   4. View all agents: /agent');
+  console.log('');
+  console.log('📚 Documentation: https://github.com/fyow/copilot-everything');
+  console.log('');
+}
+
+module.exports = { init };

package/src/index.js

@@ -0,0 +1,9 @@
+/**
+ * copilot-everything main module
+ */
+
+const { init } = require('./commands/init');
+
+module.exports = {
+  init
+};