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 | bashWindows (PowerShell)
irm https://windkeep.up.railway.app/install/install.ps1 | iexInstall 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@latestAuthentication
Interactive use: authenticate with your personal API token from the preferences page.
CI/CD: use a project service token (st_…) from Access Control, or set WINDKEEP_TOKEN and WINDKEEP_PROJECT_ID in the environment — see Guides → CI/CD.
Login validates your token and saves credentials to ~/.config/windkeep/config.yml (Linux) or %APPDATA%\windkeep\config.yml (Windows).
# Personal token — full CLI access
windkeep login YOUR_API_TOKEN
# Service token — read-only, single project (CI-friendly)
windkeep login st_YOUR_SERVICE_TOKEN
# Or use interactive mode (token input is hidden)
windkeep login
# Show your user or service-token context
windkeep whoami
# Remove stored credentials
windkeep logoutUpgrading
Download and install the latest CLI release in place.
On Windows, run windkeep --version after upgrading to finish the installation.
windkeep upgradeNext Steps
- Organizations & Projects: Manage workspaces and project containers.
- Secrets Management: Create secrets and use windkeep run.
- Guides & Troubleshooting: Workflows and common fixes.