feat: add WorkOS plugin#214
Open
saoudrizwan wants to merge 2 commits into
Open
Conversation
Contributor
Author
|
Closing this plugin PR for now because this cleanup pass is limiting plugin marketplace PRs to plugins that only bundle MCP servers and/or skills. This PR includes additional plugin primitive(s): rules. Those primitives may still be useful, but we are keeping this batch scoped to MCP and skill distribution. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
WorkOS
Adds a WorkOS plugin for Cline users building enterprise identity flows. The plugin helps Cline answer and implement WorkOS AuthKit, SSO/SAML, Directory Sync, RBAC, FGA, MFA, Vault, Audit Logs, Admin Portal, Pipes, Feature Flags, Radar, Events, Custom Domains, CLI lifecycle, API reference, and migration workflows without guessing CLI commands or dashboard paths.
Cline Primitives
workosis the main router skill. It maps WorkOS questions and implementation tasks to bundled reference files for framework-specific AuthKit setup, backend SDKs, WorkOS features, API references, management commands, and migrations from providers like Auth0, Clerk, Cognito, Firebase, Supabase, Stytch, Descope, and Better Auth.workos-widgetsguides WorkOS widget implementation for User Management, User Profile, Admin Portal SSO Connection, and Admin Portal Domain Verification. It includes stack detection, token strategy guidance, widget endpoint references, and a bundled OpenAPI query helper for schema lookup.workos:safetytells Cline to treat API keys, client secrets, cookies, session tokens, widget access tokens, webhook secrets, and exported user data as sensitive. It also requires explicit confirmation before mutating WorkOS organizations, users, roles, permissions, connections, directories, feature flags, webhooks, or production configuration.Requirements
Live WorkOS implementation work requires the user to provide the relevant WorkOS account access and credentials, commonly
WORKOS_API_KEY,WORKOS_CLIENT_ID, cookie/session secrets, webhook secrets, or widget token material.The plugin does not register an MCP server, start background services, install dependencies, call WorkOS APIs, or write MCP settings at install time. WorkOS CLI use remains a runtime action. When Cline runs the CLI, the skills steer it toward
WORKOS_MODE=agentand--jsonwhere parsing is needed, while host-sensitive auth flows can be handed back to the user’s shell if the Cline environment is not trusted for that operation.Trust Boundaries
The bundled WorkOS references are intended to reduce hallucinated WorkOS commands and dashboard paths. The plugin pushes Cline toward verified CLI help output, bundled reference files, and current WorkOS docs when current docs are needed.
Widget implementation can change application auth surfaces and user-management behavior, so the plugin keeps installer and mutation flows approval-gated and encourages manual integration from the bundled framework references when the user does not want Cline to run the WorkOS installer.