convex-workos

Integrates WorkOS AuthKit with Convex for dual-provider authentication configuration.

17|3|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/PolarCoding85/convex-agent-skillz --skill convex-workos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-workos
Source: https://github.com/PolarCoding85/convex-agent-skillz/tree/main/.claude/skills/convex-workos-skill
Command: npx skills add https://github.com/PolarCoding85/convex-agent-skillz --skill convex-workos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Streamlines authentication setup for Convex apps by integrating WorkOS AuthKit, eliminating repetitive configuration and reducing errors.

Core Features & Use Cases

  • Configures two distinct JWT issuers in convex/auth.config.ts to support WorkOS authentication.
  • Guides environment variable setup and client integration for React/Vite and Next.js.
  • Supports auto-provisioning workflows for development and provides troubleshooting guidance for common WorkOS issues.

Quick Start

Install the integration, configure convex/auth.config.ts with both providers, and wrap your app with ConvexProviderWithAuthKit.

Frequently Asked Questions about convex-workos

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate WorkOS AuthKit with my Convex application?

Configure two JWT issuers in convex/auth.config.ts, wire environment variables for client IDs, and wrap your app with ConvexProviderWithAuthKit to enable WorkOS AuthKit authentication in Convex.

Does WorkOS AuthKit support React, Vite, and Next.js environments for Convex?

Yes, WorkOS AuthKit supports React, Vite, and Next.js environments by providing specific environment variable wiring and client integration patterns to configure Convex authentication providers.

What is the purpose of configuring two JWT issuers in convex/auth.config.ts?

Configuring two JWT issuers in convex/auth.config.ts supports WorkOS authentication workflows by allowing distinct providers to separate auto-provisioned development environments from production setup.

Can I auto-provision WorkOS environments for local Convex development?

Yes, you can auto-provision WorkOS environments for local Convex development to streamline authentication setup, reducing repetitive configuration while providing documented workflows for troubleshooting common issues.

How do I troubleshoot common WorkOS authentication errors in a Convex app?

Troubleshoot WorkOS authentication errors in Convex by following documented workflows that verify environment variable wiring and auto-provisioning configurations to resolve common setup issues.