Skip to content

Konigle CLI Reference

Project Management

The Konigle CLI supports managing multiple projects/websites with different API keys and base URLs. This allows you to easily switch between different Konigle websites or environments.

Adding a Project

konigle projects add <name> --api-key <key> [--base-url <url>] [--activate]

Add a new project configuration. Project names must start with a lowercase letter and contain only lowercase letters, numbers, and hyphens.

Options:

  • --api-key: API key for the project (required)
  • --base-url: Base URL for the project (default: https://tim.konigle.com)
  • --activate: Set this project as active immediately

Examples:

# Add a project and activate it
konigle projects add my-store --api-key abc123 --activate

# Add a staging environment
konigle projects add staging-store --api-key def456 --base-url https://staging.konigle.com

Listing Projects

konigle projects list

List all configured projects and show which one is currently active.

Activating a Project

konigle projects activate <name>

Set a project as the active one. All subsequent CLI commands will use this project's configuration.

Viewing Current Project

konigle projects current

Show the currently active project and its configuration.

Removing a Project

konigle projects remove <name>

Remove a project configuration. If the removed project was active, no project will be active until you activate another one.

Configuration Priority

The CLI resolves API keys and base URLs in this order:

  1. Command-line options (--api-key, --base-url)
  2. Active project configuration
  3. Environment variables (KONIGLE_API_KEY, KONIGLE_BASE_URL)

Configuration Storage

Project configurations are stored in ~/.konigle/config.json.