# workos-wasp-drone

workos-wasp-drone — a subagent for WorkOS integration: AuthKit (UI and headless), sealed sessions, User Management, RBAC, SSO (SAML/OIDC), Directory Sync, MFA and migration from Supabase Auth or Clerk.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 96 repo stars
- Author: Legion Code Inc.
- License: AGPL-3.0-or-later · policy=link-only · description only; the file stays with the author
- Source: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/platform-and-release-tools/agents/workos-wasp-drone.md
- Updated: 2026-10-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/workos-wasp-drone

## What it does

workos-wasp-drone is a WorkOS specialist: owns AuthKit (hosted and headless modes), sealed sessions, JWT/JWKS verification, User Management API (users, organizations, memberships, invitations), RBAC model, SSO and Directory Sync, MFA/passkeys/Magic Auth support, webhook signature verification, and migrations from other providers.

The subagent reads your SvelteKit context, confirms the AuthKit mode (hosted or headless) and integration stage, then follows step-by-step guides: mode selection, wiring `@workos-inc/authkit-sveltekit`, setting up sealed sessions, modeling users and organizations, RBAC layers (route guard and data layer), SSO/SCIM for B2B, webhooks, and migrations. Runs a security checklist before handoff.

Out of scope: provider selection against other auth vendors (routed to `auth-wasp-drone`), sign-in screen JSX or branding (routed to `react-wasp-drone` or `ux-ui-svelte-stinger`), `users`/`organizations` schema design (routed to `db-wasp-drone`), or security audit of the final code (routed to `security-wasp-drone`).

## Requirements
- Works with: Supabase

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add legioncodeinc/vibe-coding-tools
```
In the agent chat (not a shell):
```text
/plugin install platform-and-release-tools@wasp-nest
```

2. **Manually: put the files in place**
- File: `.claude/agents/workos-wasp-drone.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/workos-wasp-drone.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/workos-wasp-drone.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/platform-and-release-tools/agents/workos-wasp-drone.md

## When to use it
- wire AuthKit into SvelteKit without exposing refresh tokens
- set up two-layer RBAC: route guards and data queries
- integrate SSO (SAML/OIDC) for B2B customers
- sync users and roles via SCIM Directory Sync
- migrate user base from Supabase Auth or Clerk to WorkOS

## Example prompts
- Hook up AuthKit to our SvelteKit app, show me sealed sessions
- Set up org RBAC: admin, member, viewer with data-layer checks
- Migrate 5000 users from Supabase Auth to WorkOS

## Similar
- [workos](https://affpapa.org/en/nevibecode/skills/workos.md) — skill · 3600 installs
- [workos-widgets](https://affpapa.org/en/nevibecode/skills/workos-widgets.md) — skill · 905 installs
- [authentication-patterns](https://affpapa.org/en/nevibecode/skills/travisjneuman-authentication-patterns.md) — skill · 144 installs
- [auth-and-guards](https://affpapa.org/en/nevibecode/skills/auth-and-guards.md) — skill · 219 installs
- [clerk-orgs](https://affpapa.org/en/nevibecode/skills/clerk-orgs.md) — skill · 53900 installs
- [keycloak-administration](https://affpapa.org/en/nevibecode/skills/keycloak-administration.md) — skill · 336 installs

From the same set: [legioncodeinc/vibe-coding-tools](https://affpapa.org/en/nevibecode/by/legioncodeinc/vibe-coding-tools.md) — 172 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
