v0.2.0

What's New

Platform API Support

This release introduces support for the Clerk Platform API, enabling workspace-level management of applications and transfers directly from the CLI.

New Commands:

• clerk apps list - List all applications in your workspace
• clerk apps get <app-id> - Get application details
• clerk apps create --name "My App" - Create a new application
• clerk apps update <app-id> --name "New Name" - Update application settings
• clerk apps delete <app-id> - Delete an application (with confirmation)
• clerk apps instances list <app-id> - List instances for an application
• clerk apps instances list <app-id> --include-secret-keys - Include secret keys in output

Transfer Commands:

• clerk transfers list - List all pending transfers
• clerk transfers create --app-id <id> --target-workspace <id> - Initiate application transfer
• clerk transfers accept <transfer-id> - Accept an incoming transfer
• clerk transfers cancel <transfer-id> - Cancel a pending transfer

Configuration:

Platform API uses separate authentication with ak_* keys:

# Environment variable
export CLERK_PLATFORM_KEY=ak_...

# Or in profile
clerk config set clerk.platform.key ak_...

Technical Improvements

• New PlatformClient with retry logic and exponential backoff with jitter
• Updated transfers API to use /application_transfers endpoints
• Interactive confirmation prompts for destructive operations
• Improved golangci-lint configuration

Build & Distribution

• Fixed Homebrew Cask pkg stanza placement for architecture-specific installers
• Added SHA256 checksums for signed macOS pkg files
• Suppressed noisy certificate import output in release workflow

Full Changelog

• Use /application_transfers API endpoints (99cc0a6)
• Add Platform API support (apps & transfers) (dc02abb)
• Fix Cask: move pkg stanza inside arch blocks (7fb034f)
• Add SHA256 checksums for v0.1.2 signed pkg files (778f51d)
• Suppress certificate import output in release workflow (cea795c)

v0.1.2

Release v0.1.2

- macOS code signing and notarization for .pkg installers
- Fixed Windows CI test issues
- Improved release workflow with manual trigger support

v0.1.1

release with macOS signing

v0.1.0

0.1 release

v0.0.8

What's Changed

New Features

• Billing commands — New clerk billing command group for managing billing plans, subscriptions, and statements:
  • clerk billing plans list — List all billing plans
  • clerk billing subscription get-user <userId> — Get billing subscription for a user
  • clerk billing subscription get-org <orgId> — Get billing subscription for an organization
  • clerk billing subscription-items list — List subscription items
  • clerk billing subscription-items delete — Delete a subscription item
  • clerk billing subscription-items extend-trial — Extend free trial period
  • clerk billing subscription-items transition-price — Transition to a new price
  • clerk billing statements list — List billing statements
  • clerk billing statements get — Get statement details
  • clerk billing statements payment-attempts — List payment attempts for a statement

Repository Updates

• Rename repository from clerk/gocli to clerk/cli
• Add MIT LICENSE
• Add early access notice to README
• Revise security policy and reporting guidelines
• Update release workflow to bump npm package version

v0.0.7

This update enables the CLI to detect and use CLERK_SECRET_KEY from a .env file in the current or parent directories, with a new --dotenv flag to force usage. The config resolution order and help documentation are updated, and new logic is added to prefer .env as a fallback when no profile key is set. Includes tests for .env parsing and resolution.

v0.0.6

Replaces separate allowlist and blocklist APIs and commands with a unified 'restrictions' API and CLI command. Updates documentation and help output to reflect the new structure, and moves user email and phone management under 'users emails' and 'users phones' subcommands. Improves help formatting and command descriptions for clarity.

v0.0.5

What's New

• MCP tool server integration: Added support for Model Context Protocol (MCP) tool servers, allowing the AI to call external tools for live data during rule expression generation and modification. Includes new configuration options and CLI flags.
• AI-assisted rule editing: The protect edit command now supports describing rule changes in plain English via a flag or interactive prompt, leveraging OpenAI or Anthropic providers.
• Tool call support for AI providers: Updated both OpenAI and Anthropic providers to support tool calls within the AI workflow.

Other Changes

• Updated README with GitHub authentication steps for private repo installs.
• Clarified boolean field usage in expression syntax documentation.

v0.0.4

What's New

• Protect status command: Added protect status command to view and edit protect rules and specter status
• Version in User-Agent: Added CLI version to the User-Agent header and API client

Other Changes

• Updated README with Homebrew install and update instructions

v0.0.3

What's Changed

• Refactored list API responses: Switched to ParseArrayResponse for cleaner API response handling
• Refactored invitation API: Improved response parsing and flag handling
• Fixed Homebrew formula update: Fixed the formula update script in the release workflow