@useconductor/conductor 1.0.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,33 @@
+{
+  "name": "conductor",
+  "owner": {
+    "name": "Alexander Wondwossen",
+    "email": "alex@thealxlabs.ca",
+    "url": "https://thealxlabs.ca"
+  },
+  "metadata": {
+    "description": "Conductor — Universal AI integration hub for Claude Code. Connect to GitHub, Google, Slack, Notion, Spotify, Vercel, HomeKit, and 25+ services.",
+    "version": "0.1.0"
+  },
+  "plugins": [
+    {
+      "name": "conductor",
+      "source": ".",
+      "version": "0.1.0",
+      "description": "Universal AI integration hub — connect Claude Code to 25+ services including GitHub, Gmail, Google Calendar, Drive, Slack, Notion, Spotify, Vercel, HomeKit, weather, system info, and more.",
+      "author": {
+        "name": "Alexander Wondwossen",
+        "url": "https://thealxlabs.ca"
+      },
+      "homepage": "https://github.com/thealxlabs/conductor",
+      "repository": "https://github.com/thealxlabs/conductor",
+      "license": "Apache-2.0",
+      "category": "integrations",
+      "keywords": [
+        "mcp", "github", "google", "gmail", "calendar", "drive",
+        "slack", "notion", "spotify", "vercel", "homekit",
+        "automation", "integration", "ai-hub", "weather", "n8n"
+      ]
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,23 @@
+{
+  "name": "conductor",
+  "version": "0.1.0",
+  "description": "Universal AI integration hub — connect Claude Code to GitHub, Google, Slack, Notion, Spotify, Vercel, HomeKit, and 25+ more services.",
+  "author": {
+    "name": "Alexander Wondwossen",
+    "email": "alex@thealxlabs.ca",
+    "url": "https://thealxlabs.ca"
+  },
+  "repository": "https://github.com/thealxlabs/conductor",
+  "homepage": "https://github.com/thealxlabs/conductor",
+  "license": "Apache-2.0",
+  "keywords": [
+    "integration", "mcp", "github", "google", "slack",
+    "notion", "spotify", "vercel", "homekit", "automation", "ai-hub"
+  ],
+  "category": "integrations",
+  "components": {
+    "skills": ["skills/"],
+    "commands": ["commands/"],
+    "mcpServers": ".mcp.json"
+  }
+}

package/.eslintrc.json

@@ -0,0 +1,23 @@
+{
+  "root": true,
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": 2022,
+    "sourceType": "module",
+    "project": "./tsconfig.json"
+  },
+  "plugins": ["@typescript-eslint"],
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "prettier"
+  ],
+  "rules": {
+    "@typescript-eslint/no-explicit-any": "error",
+    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
+    "@typescript-eslint/consistent-type-imports": "error",
+    "no-console": "off",
+    "prefer-const": "error"
+  },
+  "ignorePatterns": ["dist/", "node_modules/", "*.js", "*.mjs"]
+}

package/.gitattributes

@@ -0,0 +1,6 @@
+* text=auto
+*.sh text eol=lf
+*.ts text eol=lf
+*.js text eol=lf
+*.json text eol=lf
+*.ps1 text eol=crlf

package/.github/FUNDING.yml

@@ -0,0 +1,15 @@
+# These are supported funding model platforms
+
+github: thealxlabs
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: thealxlabs
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+polar: # Replace with a single Polar username
+buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+thanks_dev: # Replace with a single thanks.dev username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

package/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,91 @@
+name: Bug Report
+description: Something isn't working right
+labels: ["bug", "needs triage"]
+assignees: ["thealxlabs"]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a bug. Fill out as much as you can — it helps a lot.
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Where is the bug?
+      options:
+        - Plugin (specify below)
+        - Installer (install.sh)
+        - CLI (conductor command)
+        - Telegram bot
+        - MCP server
+        - AI provider
+        - Authentication / OAuth
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: plugin
+    attributes:
+      label: Plugin name
+      description: If the bug is in a plugin, which one?
+      placeholder: e.g. spotify, gmail, github_actions
+
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: Clear description of the bug.
+      placeholder: When I run X, Y happens instead of Z.
+    validations:
+      required: true
+
+  - type: textarea
+    id: repro
+    attributes:
+      label: Steps to reproduce
+      placeholder: |
+        1. Run `conductor ...`
+        2. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: What did you expect?
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Error output / logs
+      description: Paste any relevant terminal output here.
+      render: shell
+
+  - type: dropdown
+    id: os
+    attributes:
+      label: OS
+      options:
+        - macOS
+        - Linux
+        - Windows
+    validations:
+      required: true
+
+  - type: input
+    id: node
+    attributes:
+      label: Node.js version
+      placeholder: e.g. 20.11.0 (run `node --version`)
+    validations:
+      required: true
+
+  - type: input
+    id: conductor
+    attributes:
+      label: Conductor version
+      placeholder: e.g. 0.1.0 (run `conductor version`)

package/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Documentation
+    url: https://github.com/thealxlabs/conductor#readme
+    about: Read the README before opening an issue
+  - name: Security vulnerability
+    url: https://github.com/thealxlabs/conductor/security/advisories/new
+    about: Report security issues privately — do not open a public issue

package/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,63 @@
+name: Feature Request
+description: Suggest a new plugin, tool, or improvement
+labels: ["enhancement"]
+assignees: ["thealxlabs"]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Got an idea? Lay it out below.
+
+  - type: dropdown
+    id: type
+    attributes:
+      label: What kind of feature?
+      options:
+        - New plugin
+        - New tool in existing plugin
+        - CLI improvement
+        - Installer improvement
+        - MCP / Telegram improvement
+        - Performance
+        - Developer experience
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: plugin_name
+    attributes:
+      label: Plugin / service name
+      description: If this is about a new plugin or service integration, which one?
+      placeholder: e.g. Linear, Airtable, Slack, HomeKit
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem does this solve?
+      description: What are you trying to do that you can't do today?
+      placeholder: I want to be able to...
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: What would the solution look like?
+      description: Describe the feature. What tools would it expose? What would the output look like?
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives you've considered
+      description: Any workarounds or other approaches you've tried?
+
+  - type: checkboxes
+    id: willing
+    attributes:
+      label: Are you willing to contribute this?
+      options:
+        - label: I'd like to open a PR for this

package/.github/ISSUE_TEMPLATE/plugin_request.yml

@@ -0,0 +1,71 @@
+name: Plugin Request
+description: Request a new service integration
+labels: ["plugin-request"]
+assignees: ["thealxlabs"]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Conductor has 25 plugins and counting. Request the next one here.
+
+  - type: input
+    id: service
+    attributes:
+      label: Service / platform name
+      placeholder: e.g. Linear, Airtable, Discord, Stripe, Shopify
+    validations:
+      required: true
+
+  - type: input
+    id: api_docs
+    attributes:
+      label: API documentation URL
+      placeholder: https://developers.example.com/docs
+
+  - type: textarea
+    id: tools
+    attributes:
+      label: What tools should it expose?
+      description: List the specific things the AI should be able to do with this service.
+      placeholder: |
+        - List tasks
+        - Create and assign issues
+        - Update task status
+        - Search projects
+    validations:
+      required: true
+
+  - type: textarea
+    id: use_case
+    attributes:
+      label: Your use case
+      description: How would you actually use this in Conductor / Telegram / Claude Desktop?
+    validations:
+      required: true
+
+  - type: dropdown
+    id: auth
+    attributes:
+      label: How does the API authenticate?
+      options:
+        - API key
+        - OAuth 2.0
+        - OAuth 1.0a
+        - Bearer token
+        - Basic auth
+        - Other / not sure
+    validations:
+      required: true
+
+  - type: dropdown
+    id: free_tier
+    attributes:
+      label: Does it have a free tier?
+      options:
+        - "Yes — fully free"
+        - "Yes — free tier with limits"
+        - "No — paid only"
+        - "Not sure"
+    validations:
+      required: true

package/.github/README.md

@@ -0,0 +1,13 @@
+# .github
+
+GitHub configuration for the Conductor repository.
+
+## Contents
+
+- `workflows/` - GitHub Actions CI/CD workflows
+- `ISSUE_TEMPLATE/` - Issue templates for bug reports and feature requests
+- `FUNDING.yml` - Sponsorship configuration
+
+## Architecture
+
+This directory contains GitHub-specific repository configuration. Workflows handle CI, releases, and automated tasks. Issue templates standardize how contributors report bugs and request features.

package/.github/workflows/README.md

@@ -0,0 +1,22 @@
+# .github/workflows
+
+GitHub Actions CI/CD workflows for Conductor.
+
+## Contents
+
+- `ci.yml` - Continuous integration: lint, typecheck, test, build
+- `auto-release.yml` - Automated release creation
+- `claude-code-review.yml` - AI-assisted code review
+- `claude.yml` - Claude Code automation
+- `sync-install.yml` - Install script synchronization
+
+## Architecture
+
+These workflows automate the development lifecycle:
+
+- **CI** runs on every push/PR to ensure code quality
+- **Auto-release** publishes new versions on tag creation
+- **Claude workflows** provide AI-assisted review and automation
+- **Sync-install** keeps installation scripts up to date
+
+All workflows run on GitHub's infrastructure and are triggered by push, pull request, or schedule events.

package/.github/workflows/auto-release.yml

@@ -0,0 +1,112 @@
+name: Auto Release
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Get version from commit
+        id: version
+        run: |
+          SHORT_SHA=$(git rev-parse --short HEAD)
+          DATE=$(date +'%Y.%m.%d')
+          echo "version=v${DATE}-${SHORT_SHA}" >> $GITHUB_OUTPUT
+
+      - name: Generate changelog
+        id: changelog
+        run: |
+          LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
+
+          if [ -z "$LAST_TAG" ]; then
+            echo "No previous tags — using full commit history."
+            COMMITS=$(git log --pretty=format:"%s|%h|%an" --no-merges | head -50)
+          else
+            echo "Generating changelog since $LAST_TAG"
+            COMMITS=$(git log "${LAST_TAG}..HEAD" --pretty=format:"%s|%h|%an" --no-merges)
+          fi
+
+          if [ -z "$COMMITS" ]; then
+            echo "_No changes recorded._" > release_notes.md
+            exit 0
+          fi
+
+          FEATS=""
+          FIXES=""
+          PERF=""
+          CHORE=""
+          OTHER=""
+
+          while IFS='|' read -r subject hash author; do
+            ENTRY="- ${subject} (\`${hash}\`) — ${author}"
+            case "$subject" in
+              feat*|add*|new*)     FEATS="$FEATS\n$ENTRY" ;;
+              fix*|bug*|patch*)    FIXES="$FIXES\n$ENTRY" ;;
+              perf*|optim*)        PERF="$PERF\n$ENTRY" ;;
+              chore*|ci*|build*|docs*|refactor*|test*|style*) CHORE="$CHORE\n$ENTRY" ;;
+              *)                   OTHER="$OTHER\n$ENTRY" ;;
+            esac
+          done <<< "$COMMITS"
+
+          {
+            echo "## What's Changed"
+            echo ""
+            echo "> Commit: \`${{ github.sha }}\`"
+            echo "> Branch: \`${{ github.ref_name }}\`"
+            echo "> Author: ${{ github.actor }}"
+            echo ""
+
+            if [ -n "$FEATS" ]; then
+              echo "### ✨ New Features"
+              printf "%b\n\n" "$FEATS"
+            fi
+            if [ -n "$FIXES" ]; then
+              echo "### 🐛 Bug Fixes"
+              printf "%b\n\n" "$FIXES"
+            fi
+            if [ -n "$PERF" ]; then
+              echo "### ⚡ Performance"
+              printf "%b\n\n" "$PERF"
+            fi
+            if [ -n "$OTHER" ]; then
+              echo "### 🔀 Other Changes"
+              printf "%b\n\n" "$OTHER"
+            fi
+            if [ -n "$CHORE" ]; then
+              echo "### 🔧 Maintenance"
+              printf "%b\n\n" "$CHORE"
+            fi
+
+            if [ -n "$LAST_TAG" ]; then
+              echo "---"
+              echo "**Full diff:** https://github.com/${{ github.repository }}/compare/${LAST_TAG}...${{ steps.version.outputs.version }}"
+            fi
+          } > release_notes.md
+
+      - name: Create GitHub Release
+        run: |
+          gh release create "${{ steps.version.outputs.version }}" \
+            --title "Conductor ${{ steps.version.outputs.version }}" \
+            --notes-file release_notes.md \
+            --latest
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Summary
+        if: always()
+        run: |
+          echo "### ✅ Released" >> $GITHUB_STEP_SUMMARY
+          echo "**Conductor \`${{ steps.version.outputs.version }}\`** has been published." >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          cat release_notes.md >> $GITHUB_STEP_SUMMARY

package/.github/workflows/ci.yml

@@ -0,0 +1,49 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [18, 20, 22]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Type check
+        run: npm run typecheck
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Format check
+        run: npm run format:check
+
+      - name: Build
+        run: npm run build
+
+      - name: Test
+        run: npm test
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        if: matrix.node-version == 22
+        with:
+          files: ./coverage/lcov.info
+          fail_ci_if_error: false

package/.github/workflows/claude-code-review.yml

@@ -0,0 +1,44 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize, ready_for_review, reopened]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+jobs:
+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          plugin_marketplaces: 'https://github.com/anthropics/claude-code.git'
+          plugins: 'code-review@claude-code-plugins'
+          prompt: '/code-review:code-review ${{ github.repository }}/pull/${{ github.event.pull_request.number }}'
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+

package/.github/workflows/claude.yml

@@ -0,0 +1,36 @@
+name: Claude Code
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      issues: write
+      id-token: write
+      actions: read
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          additional_permissions: |
+            actions: read

package/.github/workflows/sync-install.yml

@@ -0,0 +1,47 @@
+name: Sync install.sh to website
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'install.sh'
+      - 'install.ps1'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout conductor repo
+        uses: actions/checkout@v4
+
+      - name: Push install scripts to website repo
+        env:
+          TOKEN: ${{ secrets.WEBSITE_REPO_TOKEN }}
+        run: |
+          WEBSITE_REPO="thealxlabs/conductor-website"
+
+          git config --global user.name  "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+
+          git clone https://x-access-token:${TOKEN}@github.com/${WEBSITE_REPO}.git website-repo
+
+          cp install.sh website-repo/install.sh
+          cp install.ps1 website-repo/install.ps1
+
+          cd website-repo
+
+          git add install.sh install.ps1
+
+          # Only commit if there are staged changes
+          if git diff --cached --quiet; then
+            echo "No changes, skipping commit."
+            exit 0
+          fi
+
+          git commit -m "sync: update install scripts from conductor@${{ github.sha }}"
+          git push

package/.mcp.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "conductor": {
+      "command": "node",
+      "args": ["./dist/cli/index.js", "mcp", "start"],
+      "env": {}
+    }
+  }
+}

package/.prettierrc.json

@@ -0,0 +1,7 @@
+{
+  "semi": true,
+  "trailingComma": "all",
+  "singleQuote": true,
+  "printWidth": 120,
+  "tabWidth": 2
+}