Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
dda92fc
feat(one-shot): add one-shot API client and config store type extension
nicknisi Mar 10, 2026
59fc5ea
feat(one-shot): add install flow credential resolution and claim command
nicknisi Mar 10, 2026
725e480
feat(one-shot): add unclaimed environment warning and env list label
nicknisi Mar 10, 2026
9a2a938
chore: remove case files
nicknisi Mar 10, 2026
7dfd71e
chore: run formatter on one-shot mode files
nicknisi Mar 11, 2026
046aac0
fix(one-shot): send snake_case fields to claim-nonces endpoint
nicknisi Mar 11, 2026
cf1bab2
fix(one-shot): make unclaimed environment warning more visible
nicknisi Mar 11, 2026
833ad57
refactor: rename one-shot to unclaimed-env throughout codebase
nicknisi Mar 11, 2026
bdcc042
chore: remove unused withAuth function
nicknisi Mar 11, 2026
5cf75ea
docs: add unclaimed environments and claim command to README
nicknisi Mar 11, 2026
a4961a2
fix: use green box for provisioning success message
nicknisi Mar 11, 2026
59459db
refactor: simplify unclaimed env code — dedupe utilities, remove netw…
nicknisi Mar 11, 2026
d0f5427
fix: handle 409 as claimed status, handle 401 as invalid/expired token
nicknisi Mar 12, 2026
8f547df
feat(auth): add claim token proxy for unclaimed environment gateway auth
nicknisi Mar 12, 2026
ecc2615
fix(claim): don't block on browser open — use wait: false for opn
nicknisi Mar 12, 2026
184f844
fix(install): detect missing gateway auth after claiming — prompt log…
nicknisi Mar 12, 2026
ba4b05a
feat: add hidden `debug` command for developer-facing CLI introspection
nicknisi Mar 12, 2026
b05753a
chore: formatting:
nicknisi Mar 12, 2026
9a7417c
feat(debug): add `env` subcommand — show WORKOS_* env vars and their …
nicknisi Mar 12, 2026
bbfaa03
chore: formatting:
nicknisi Mar 12, 2026
f7f0fad
refactor: dedupe proxy helpers and move unclaimed warning to yargs mi…
nicknisi Mar 13, 2026
f17b298
fix: config persistence across processes and improve debug diagnostics
nicknisi Mar 13, 2026
9f6d668
docs: update README to reflect zero-auth credential resolution
nicknisi Mar 13, 2026
9175ec7
fix: improve type safety, error handling, and exit codes across uncla…
nicknisi Mar 13, 2026
f0f86e8
fix: address PR review suggestions for unclaimed flow
nicknisi Mar 13, 2026
cf37617
fix: address PR review — error handling, type safety, and test coverage
nicknisi Mar 13, 2026
52e630a
chore: formatting
nicknisi Mar 13, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -36,3 +36,6 @@ tests/eval-results/

# Local ideation artifacts
docs/

# Case harness markers
.case-*
21 changes: 20 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,7 @@ workos [command]

Commands:
install Install WorkOS AuthKit into your project
claim Claim an unclaimed environment (link to your account)
auth Manage authentication (login, logout, status)
env Manage environment configurations
doctor Diagnose WorkOS integration issues
Expand Down Expand Up @@ -85,6 +86,24 @@ Workflows:

All management commands support `--json` for structured output (auto-enabled in non-TTY) and `--api-key` to override the active environment's key.

### Unclaimed Environments

When you run `workos install` without credentials, the CLI automatically provisions a temporary WorkOS environment — no account needed. This lets you try AuthKit immediately.

```bash
# Install with zero setup — environment provisioned automatically
workos install

# Check your environment
workos env list
# Shows: unclaimed (unclaimed) ← active

# Claim the environment to link it to your WorkOS account
workos claim
```

Management commands work on unclaimed environments with a warning reminding you to claim.

### Workflows

The compound workflow commands compose multiple API calls into common operations. These are the highest-value commands for both developers and AI agents.
Expand Down Expand Up @@ -483,7 +502,7 @@ OAuth credentials are stored in the system keychain (with `~/.workos/credentials
## How It Works

1. **Detects** your framework and project structure
2. **Prompts** for WorkOS credentials (API key masked)
2. **Resolves credentials** — uses existing config, or auto-provisions an unclaimed environment if none found
3. **Auto-configures** WorkOS dashboard (redirect URI, CORS, homepage URL)
4. **Fetches** latest SDK documentation from workos.com
5. **Uses AI** (Claude) to generate integration code
Expand Down
248 changes: 228 additions & 20 deletions src/bin.ts

Large diffs are not rendered by default.

Loading
Loading