extension-architecture

name

extension-architecture

description

Copilot CLI extension development and architecture — file structure, joinSession API, hook types, tool registration, env file patterns, polling intervals, and extension registry. Use when user says "create extension", "modify extension", "extension architecture", "how extensions work", "add tool", "extension hooks", "onPostToolUse", "onPreToolUse", "extension.mjs", or any extension development activity.

Extension Architecture Skill

How Copilot CLI extensions work in the {{FAMILY_NAME}} family platform. Reference this when building, modifying, or debugging extensions.

File Structure

Every extension lives in .github/extensions/{name}/extension.mjs:

.github/extensions/
├── action-tracker/extension.mjs      # Task/shopping/meal/maintenance tools
├── ask-via-telegram/extension.mjs    # Routes ask_user → Telegram
├── audit-log/extension.mjs           # Logging/audit trail
├── auto-commit/extension.mjs         # Git auto-save on file changes
├── budget-tracker/extension.mjs      # Plaid financial connector tools
├── cron-scheduler/extension.mjs      # Cron job scheduler (reads cron.json)
├── dev-workflow/extension.mjs        # Multi-repo dev with git worktrees
├── exa/extension.mjs                 # Exa AI search & crawl tools
├── family-data/extension.mjs         # Family profiles, preferences
├── financial-connector/extension.mjs # Plaid API integration
├── google-maps/extension.mjs         # Drive time, directions, routes
├── google-services/extension.mjs     # Gmail, GCal, GTasks tools
├── home-maintenance/extension.mjs    # Maintenance schedule tools
├── image-gen/extension.mjs           # OpenAI gpt-image-2 image generation
├── late-api/extension.mjs            # Late/Zernio social media API
├── life-events/extension.mjs         # Family milestone tracking
├── locations/extension.mjs           # Saved places management
├── meal-planner/extension.mjs        # Meals, recipes, grocery lists
├── perplexity/extension.mjs          # Perplexity AI research tools
├── self-restart/extension.mjs        # Session restart tool
├── shopping-list/extension.mjs       # Shopping list CRUD
├── tasker-bridge/extension.mjs       # Tasker TTS integration
├── telegram-bridge/extension.mjs     # Telegram messaging bridge
├── twilio-sms/extension.mjs          # Twilio SMS messaging
├── vercel-env/extension.mjs          # Vercel project & env management
├── video-analyzer/extension.mjs      # Gemini video analysis tool
├── video-bridge/extension.mjs        # Video recording upload bridge