Command Line Interface

Overview

The WindKeep CLI lets you manage secrets, organizations, and projects from your terminal. It is the fastest way to create projects, rotate keys, and run local commands with injected environment variables — without maintaining .env files.

You can use wk as a shortcut for windkeep.

Quick Installation

Run the install script for your platform. It downloads the binary and updates your PATH.

Restart your terminal after installing, then run windkeep --version to verify.

Linux

curl -sSL https://windkeep.up.railway.app/install/install.sh | bash

Windows (PowerShell)

irm https://windkeep.up.railway.app/install/install.ps1 | iex

Install via Go

If you already have Go installed, you can build and install the CLI from source. The binary is placed in your Go bin directory ($GOBIN, $GOPATH/bin, or ~/go/bin by default) — make sure that directory is on your PATH.

This method does not set up the wk shortcut.

go install github.com/matimortari/windkeep/cli@latest

Authentication

Before running other commands, authenticate with your API token. Copy it from the preferences page in the WindKeep dashboard.

Login validates your token and saves credentials to ~/.config/windkeep/config.yml (Linux) or %APPDATA%\windkeep\config.yml (Windows).

# Authenticate with your API token
windkeep login YOUR_API_TOKEN

# Or use interactive mode (token input is hidden)
windkeep login

# Show your user and active org/project context
windkeep whoami

# Remove stored credentials
windkeep logout

Upgrading

Download and install the latest CLI release in place.

On Windows, run windkeep --version after upgrading to finish the installation.

windkeep upgrade

Next Steps