workos 0.8.2 → 0.10.0

package/README.md

@@ -15,7 +15,7 @@ workos
 
 ## Features
 
-- **5 Framework Support:** Next.js, React Router, TanStack Start, React SPA, Vanilla JS
+- **15 Framework Support:** Next.js, React Router, TanStack Start, React SPA, Vanilla JS, SvelteKit, Node.js (Express), Python (Django), Ruby (Rails), Go, .NET (ASP.NET Core), Kotlin (Spring Boot), Elixir (Phoenix), PHP (Laravel), PHP
 - **AI-Powered:** Uses Claude to intelligently adapt to your project structure
 - **Security-First:** Masks API keys, redacts from logs, saves to .env.local
 - **Smart Detection:** Auto-detects framework, package manager, router type
@@ -50,11 +50,10 @@ workos [command]
 
 Commands:
   install                Install WorkOS AuthKit into your project
-  login                  Authenticate with WorkOS via browser OAuth
-  logout                 Remove stored credentials
+  auth                   Manage authentication (login, logout, status)
   env                    Manage environment configurations
   doctor                 Diagnose WorkOS integration issues
-  install-skill          Install AuthKit skills to coding agents
+  skills                 Manage WorkOS skills for coding agents (install, uninstall, list)
 
 Resource Management:
   organization (org)     Manage organizations
@@ -364,7 +363,7 @@ workos org-domain delete <id>
 workos install [options]
 
   --direct, -D            Use your own Anthropic API key (bypass llm-gateway)
-  --integration <name>    Framework: nextjs, react, react-router, tanstack-start, vanilla-js
+  --integration <name>    Framework: nextjs, react, react-router, tanstack-start, vanilla-js, sveltekit, node, python, ruby, go, dotnet, kotlin, elixir, php-laravel, php
   --api-key <key>         WorkOS API key (required in non-interactive mode)
   --client-id <id>        WorkOS client ID (required in non-interactive mode)
   --redirect-uri <uri>    Custom redirect URI
@@ -386,7 +385,7 @@ workos install [options]
 npx workos
 
 # Specify framework
-npx workos --integration react-router
+npx workos install --integration react-router
 
 # With visual dashboard (experimental)
 npx workos dashboard
@@ -470,10 +469,13 @@ The CLI uses WorkOS Connect OAuth device flow for authentication:
 
 ```bash
 # Login (opens browser for authentication)
-workos login
+workos auth login
+
+# Check current auth status
+workos auth status
 
 # Logout (clears stored credentials)
-workos logout
+workos auth logout
 ```
 
 OAuth credentials are stored in the system keychain (with `~/.workos/credentials.json` fallback). Access tokens are not persisted long-term for security - users re-authenticate when tokens expire.

package/dist/bin.js

@@ -20,7 +20,7 @@ if (!satisfies(process.version, NODE_VERSION_RANGE)) {
     process.exit(1);
 }
 import { isNonInteractiveEnvironment } from './utils/environment.js';
-import { resolveOutputMode, setOutputMode, outputJson, exitWithError } from './utils/output.js';
+import { resolveOutputMode, setOutputMode, isJsonMode, outputJson, exitWithError } from './utils/output.js';
 import clack from './utils/clack.js';
 import { registerSubcommand } from './utils/register-subcommand.js';
 // Resolve output mode early from raw argv (before yargs parses)
@@ -163,8 +163,9 @@ const installerOptions = {
         type: 'boolean',
     },
 };
-// Check for updates (blocks up to 500ms)
-await checkForUpdates();
+// Check for updates (blocks up to 500ms, skip in JSON mode to keep stdout clean)
+if (!isJsonMode())
+    await checkForUpdates();
 yargs(rawArgs)
     .env('WORKOS_INSTALLER')
     .option('json', {
@@ -173,44 +174,78 @@ yargs(rawArgs)
     describe: 'Output results as JSON (auto-enabled in non-TTY)',
     global: true,
 })
-    .command('login', 'Authenticate with WorkOS via browser-based OAuth', insecureStorageOption, async (argv) => {
-    await applyInsecureStorage(argv.insecureStorage);
-    const { runLogin } = await import('./commands/login.js');
-    await runLogin();
-    process.exit(0);
-})
-    .command('logout', 'Remove stored WorkOS credentials and tokens', insecureStorageOption, async (argv) => {
-    await applyInsecureStorage(argv.insecureStorage);
-    const { runLogout } = await import('./commands/logout.js');
-    await runLogout();
+    .command('auth', 'Manage authentication (login, logout, status)', (yargs) => {
+    yargs.options(insecureStorageOption);
+    registerSubcommand(yargs, 'login', 'Authenticate with WorkOS via browser-based OAuth', (y) => y, async (argv) => {
+        await applyInsecureStorage(argv.insecureStorage);
+        const { runLogin } = await import('./commands/login.js');
+        await runLogin();
+        process.exit(0);
+    });
+    registerSubcommand(yargs, 'logout', 'Remove stored WorkOS credentials and tokens', (y) => y, async (argv) => {
+        await applyInsecureStorage(argv.insecureStorage);
+        const { runLogout } = await import('./commands/logout.js');
+        await runLogout();
+    });
+    registerSubcommand(yargs, 'status', 'Show current authentication status', (y) => y, async (argv) => {
+        await applyInsecureStorage(argv.insecureStorage);
+        const { runAuthStatus } = await import('./commands/auth-status.js');
+        await runAuthStatus();
+    });
+    return yargs.demandCommand(1, 'Please specify an auth subcommand').strict();
 })
-    .command('install-skill', 'Install bundled AuthKit skills to coding agents (Claude Code, Codex, Cursor, Goose)', (yargs) => {
-    return yargs
-        .option('list', {
-        alias: 'l',
-        type: 'boolean',
-        description: 'List available skills without installing',
+    .command('skills', 'Manage WorkOS skills for coding agents (Claude Code, Codex, Cursor, Goose)', (yargs) => {
+    registerSubcommand(yargs, 'install', 'Install bundled AuthKit skills to coding agents', (y) => y
+        .option('skill', {
+        alias: 's',
+        type: 'array',
+        string: true,
+        description: 'Install specific skill(s) by name',
     })
+        .option('agent', {
+        alias: 'a',
+        type: 'array',
+        string: true,
+        description: 'Target specific agent(s): claude-code, codex, cursor, goose',
+    }), async (argv) => {
+        const { runInstallSkill } = await import('./commands/install-skill.js');
+        await runInstallSkill({
+            skill: argv.skill,
+            agent: argv.agent,
+        });
+    });
+    registerSubcommand(yargs, 'uninstall', 'Remove installed WorkOS skills from coding agents', (y) => y
         .option('skill', {
         alias: 's',
         type: 'array',
         string: true,
-        description: 'Install specific skill(s)',
+        description: 'Remove specific skill(s) by name',
     })
         .option('agent', {
         alias: 'a',
         type: 'array',
         string: true,
         description: 'Target specific agent(s): claude-code, codex, cursor, goose',
+    }), async (argv) => {
+        const { runUninstallSkill } = await import('./commands/uninstall-skill.js');
+        await runUninstallSkill({
+            skill: argv.skill,
+            agent: argv.agent,
+        });
     });
-}, withAuth(async (argv) => {
-    const { runInstallSkill } = await import('./commands/install-skill.js');
-    await runInstallSkill({
-        list: argv.list,
-        skill: argv.skill,
-        agent: argv.agent,
+    registerSubcommand(yargs, 'list', 'List available and installed skills', (y) => y.option('agent', {
+        alias: 'a',
+        type: 'array',
+        string: true,
+        description: 'Target specific agent(s): claude-code, codex, cursor, goose',
+    }), async (argv) => {
+        const { runListSkills } = await import('./commands/list-skills.js');
+        await runListSkills({
+            agent: argv.agent,
+        });
     });
-}))
+    return yargs.demandCommand(1, 'Please specify a skills subcommand').strict();
+})
     .command('doctor', 'Diagnose WorkOS AuthKit integration issues in the current project', (yargs) => yargs.options({
     verbose: {
         type: 'boolean',