v1.0.0

Clerk CLI 1.0.0 is the first stable 1.x release of the standalone clerk command line tool.

This release marks the CLI as a stable, supported interface for working with Clerk from the terminal: bootstrapping new projects, authenticating, linking apps, pulling environment variables, inspecting and updating instance configuration, making direct API requests, running integration health checks, switching environments, opening dashboard resources, installing the bundled Clerk agent skill, and updating the CLI itself.

Core workflows available in Clerk CLI 1.0.0 include:

• clerk init to bootstrap Clerk into supported projects and starters
• clerk auth, clerk whoami, clerk link, and clerk unlink for account and project association
• clerk env pull for pulling Clerk environment variables into local env files
• clerk config pull, schema, patch, and put for instance configuration management
• clerk api and clerk apps for direct platform access from the terminal
• clerk doctor for integration diagnostics and guided fixes
• clerk open, clerk switch-env, clerk completion, clerk skill install, and clerk update for day-to-day developer workflows

Install Clerk CLI:

# Homebrew (macOS / Linux)
brew install clerk/stable/clerk

# npm
npm install -g clerk

See the autogenerated notes below for the full PR-by-PR changelog included in this 1.0.0 release.

What's Changed

• refactor(ci): extract reusable CI checks and setup-bun composite action by @wyattjoh in #152
• fix(homebrew): desc must not start with formula name by @wyattjoh in #182
• fix(init): simplify auth/keyless flow and fix --starter by @rafa-thayto in #175
• feat(log): expand --verbose diagnostics and surface silent env fallback by @wyattjoh in #183
• feat: Clerk CLI Skill by @wyattjoh in #126
• fix(update): PATH-priority installer detection, asdf shims, --all by @rafa-thayto in #179
• fix(config): Normalize keys and improve help text by @dmoerner in #187
• fix(skill): fix clerk skill install failing on published releases by @wyattjoh in #189
• fix(e2e): drop unused @tailwindcss/typography from tanstack fixture by @wyattjoh in #190
• docs(rules): add script authoring conventions by @wyattjoh in #153
• docs(skill): add audit-clerk-skill for drift detection by @wyattjoh in #156
• fix(init): tighten bootstrap flow (skip redundant confirm, put next steps last) by @rafa-thayto in #184
• feat(prompts): add scroll indicators and interactive listage module by @rafa-thayto in #176
• feat(push): dry-run diff by @dmoerner in #188
• Fix: Link command uses wrong directory during bootstrap flow by @kylemac in #186
• feat(help): surface agent skill install in clerk --help by @rafa-thayto in #191
• feat(init): install all core and feature skills by default by @rafa-thayto in #185
• docs(skill): document --all flag on clerk update by @wyattjoh in #196
• feat: auto-claim keyless applications on login by @rafa-thayto in #157
• fix(init): pull API keys into bootstrapped project subdirectory by @rafa-thayto in #195
• fix(build): install all platform keyring bindings for cross-compile by @wyattjoh in #198
• feat(plapi): stamp from_source=cli on authenticated app creation by @mwickett in #192
• feat(release): prepare clerk 1.0.0 release by @wyattjoh in #199
• fix(auth): isolate unsigned macOS keychain entries by @wyattjoh in #201
• feat(auth): opt in to dashboard CLI OAuth flow via clerk_client=cli by @djgould in #193
• fix(release): install.sh --install-dir and release docs by @wyattjoh in #202
• fix(release): make snapshot commit ids semver-safe for bunx by @wyattjoh in #207
• fix(config): Run server-side dry-run by @dmoerner in #200
• fix(env-pull): default to .env.local on Next.js projects by @rafa-thayto in #204
• Refactor credential file storage to use writeFile with mode by @dominic-clerk in #203
• build(deps): bump @inquirer/core from 11.1.8 to 11.1.9 by @dependabot[bot] in #211
• build(deps): bump @inquirer/prompts from 8.4.1 to 8.4.2 by @dependabot[bot] in #210
• build(deps-dev): bump @changesets/cli from 2.30.0 to 2.31.0 by @dependabot[bot] in #209
• build(deps-dev): bump typescript from 6.0.2 to 6.0.3 by @dependabot[bot] in #208
• fix(completion): make install tips work on fresh systems by @rafa-thayto in #206
• feat(help): suppress skill-install tip when skill is already installed by @rafa-thayto in #194
• fix(cli-core): support agent-mode link and unlink by @wyattjoh in #212
• feat(auth): add OAuth refresh token session handling by @wyattjoh in #205
• ci(repo): Version Packages by @github-actions[bot] in #181

New Contributors

• @mwickett made their first contribution in #192

Full Changelog: v0.8.4...v1.0.0