Skip to content

README.md

Latest commit

 

History

History
196 lines (138 loc) · 8.33 KB

README.md

File metadata and controls

196 lines (138 loc) · 8.33 KB
Raw

conductor-plugins

Official plugin registry for Conductor — the AI integration hub.

Install any plugin in one command:

conductor plugins install slack
conductor plugins install github
conductor plugins install stripe

Browse all plugins at conductor.thealxlabs.ca/marketplace.

Available Plugins (31)

Developer Tools

Plugin Tools Description Install
github 5 Repositories, user profiles, trending — public data, no token needed conductor plugins install github
github-actions 16 Trigger workflows, manage PRs, issues, releases, and notifications conductor plugins install github-actions
gitlab — Projects, issues, merge requests, and pipelines conductor plugins install gitlab
vercel 15 Deployments, logs, domains, and environment variables conductor plugins install vercel
linear — Issues, cycles, projects, and team management conductor plugins install linear
jira — Issues, sprints, projects, and boards conductor plugins install jira
figma — Files, nodes, components, and comments conductor plugins install figma

Communication

Plugin Tools Description Install
slack 7 Send messages, read channels, search, manage workspaces conductor plugins install slack
discord — Send messages, manage channels and servers conductor plugins install discord
gmail 8 Read, search, send, and manage Gmail conductor plugins install gmail
twilio — Send SMS, make calls, manage phone numbers conductor plugins install twilio
sendgrid — Send transactional and marketing email conductor plugins install sendgrid
x 7 Post tweets, search, get timelines and user info conductor plugins install x

Google Workspace

Plugin Tools Description Install
gcal 7 Read and manage Google Calendar events conductor plugins install gcal
gdrive 8 List, search, read, and upload files in Google Drive conductor plugins install gdrive
gmail 8 Read, search, send, and manage Gmail conductor plugins install gmail

Productivity

Plugin Tools Description Install
notion 7 Read, search, and create pages and databases conductor plugins install notion
airtable — Bases, tables, records, and field management conductor plugins install airtable
monday — Boards, items, columns, and updates conductor plugins install monday
asana — Projects, tasks, teams, and workspaces conductor plugins install asana
trello — Boards, lists, cards, and members conductor plugins install trello

Finance & Commerce

Plugin Tools Description Install
stripe — Charges, customers, subscriptions, and payment intents conductor plugins install stripe
shopify — Products, orders, customers, and inventory conductor plugins install shopify

AI & ML

Plugin Tools Description Install
openai — Chat completions, embeddings, and fine-tuning conductor plugins install openai
anthropic — Claude completions and model management conductor plugins install anthropic

Analytics

Plugin Tools Description Install
posthog — Events, feature flags, cohorts, and insights conductor plugins install posthog

Databases

Plugin Tools Description Install
redis — Get, set, delete, list, and pub/sub operations conductor plugins install redis
supabase — Tables, auth, storage, and edge functions conductor plugins install supabase

Automation

Plugin Tools Description Install
n8n 13 Trigger workflows, manage executions, fire webhooks conductor plugins install n8n

Social & Entertainment

Plugin Tools Description Install
spotify 15 Playback control, search, playlists, and recommendations conductor plugins install spotify

Utilities

Plugin Tools Description Install
weather 3 Current conditions and 7-day forecasts — no API key needed conductor plugins install weather

Smart Home

Plugin Tools Description Install
homekit 7 Control HomeKit smart home devices via Homebridge conductor plugins install homekit

How It Works

When you run conductor plugins install <id>, Conductor:

  1. Fetches the registry from https://raw.githubusercontent.com/thegreatalxx/conductor-plugins/main/registry.json
  2. Finds the plugin entry and its compiled asset path
  3. Downloads the .js file directly from this repo via GitHub's raw content URL
  4. Saves it to ~/.conductor/plugins/<id>.js
  5. Dynamically imports it — no restart required

Plugins are compiled TypeScript. The source lives in plugins/<id>/src/, the compiled output in plugins/<id>/dist/<id>.js. The dist/ folders are committed so they can be downloaded without a build step.

Plugin Structure

Each plugin folder follows this layout:

plugins/
└── slack/
    ├── package.json       # Plugin metadata
    ├── tsconfig.json      # TypeScript config
    ├── src/
    │   └── index.ts       # Plugin source (implements Plugin interface)
    └── dist/
        └── slack.js       # Compiled output — this is what Conductor downloads

The compiled dist/<id>.js must export a class implementing the Conductor Plugin interface:

export class MyPlugin implements Plugin {
  name = 'my-plugin';
  description = 'What it does';
  version = '1.0.0';

  async initialize(conductor: Conductor): Promise<void> { /* setup */ }
  isConfigured(): boolean { /* return true if ready */ }
  getTools(): PluginTool[] { /* return tool definitions */ }
}

See docs/plugin-authoring.md for the full authoring guide.

Creating a Plugin

  1. Scaffold with conductor plugin-create <name> — this generates the folder structure
  2. Implement your plugin in src/index.ts
  3. Build with npm run build inside the plugin folder
  4. Test locally: drop the compiled dist/<id>.js into ~/.conductor/plugins/ and run conductor plugins list
  5. Submit a Plugin Submission issue with your PR

All submitted plugins are reviewed for security and code quality before being merged.

Contributing

  • Read docs/plugin-authoring.md
  • Follow the plugin structure above
  • Make sure your plugin compiles cleanly with tsc --noEmit
  • Open a PR — one plugin per PR please

Security

This repo distributes code that runs on your machine with access to your credentials and services.

  • All plugins are reviewed before being added to the registry
  • Plugins run in the same process as Conductor — they are not sandboxed
  • Credentials are stored in your OS keychain, never in plain text
  • Report vulnerabilities privately via SECURITY.md — do not open a public issue

License

Apache 2.0 — see LICENSE.

Built by TheAlxLabs. Not affiliated with any of the services these plugins connect to.