Command Line Interface

The WindKeep Command Line Interface allows you to manage secrets, organizations, and projects directly from your terminal. Fast, secure, and designed for developers who prefer working in the command line.

Installation

Shell Script (Linux / macOS)

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

PowerShell Script (Windows)

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

Manual Download

Installation Steps

Linux / macOS

  1. Download the binary
  2. Open terminal and navigate to downloads:
cd ~/Downloads
  1. Make it executable:
chmod +x windkeep-*
  1. Move it to a directory in your PATH:
mv windkeep-* ~/.local/bin/windkeep
  1. Ensure ~/.local/bin is in your PATH:
export PATH="$HOME/.local/bin:$PATH"
  1. Verify:
windkeep --version

Windows

  1. Download the .exe file
  2. Move it to:
Move-Item windkeep-windows-amd64.exe $env:LOCALAPPDATA\Programs\windkeep\windkeep.exe
  1. Add this directory to your PATH:
%LOCALAPPDATA%\Programs\windkeep
  1. Restart your terminal and verify:
windkeep --version

Authentication

Login

First, sign in to WindKeep and retrieve your API token:

  1. Navigate to your preferences page
  2. Copy your API token
  3. Run:
# Pass token as argument
windkeep login YOUR_API_TOKEN

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

This validates your token and saves your configuration in ~/.windkeep/config.yaml.

Whoami

Display information about your currently authenticated user and active context.

Example:

windkeep whoami

Logout

Remove stored authentication credentials by running:

windkeep logout

This deletes your local configuration file. You'll need to run windkeep login again to authenticate.

Next Steps

Now that you're set up, explore the documentation: