Invariable CLI

Invariable CLI (invar) is a command-line wrapper for Invariable. It works hand-in-hand with the macOS app to securely store and load environment variables into locally running apps.

Installation

Invariable CLI requires macOS. Install a prebuilt binary for Apple Silicon or Intel macs with:

curl -fsSL https://raw.githubusercontent.com/Triplane/invariable-cli/main/scripts/install.sh | sh

The script detects your Mac's architecture (Apple Silicon or Intel), downloads the matching binary, verifies its checksum, and installs invar to ~/.local/bin.

Override the defaults with environment variables:

# Pin a specific version
curl -fsSL https://raw.githubusercontent.com/Triplane/invariable-cli/main/scripts/install.sh | INVAR_VERSION=v0.1.0 sh

# Install somewhere else
curl -fsSL https://raw.githubusercontent.com/Triplane/invariable-cli/main/scripts/install.sh | INVAR_INSTALL_DIR=/usr/local/bin sh

Development

Requirements

• macOS
• Rust toolchain with cargo
• Invariable.app running for real --ping, --list, and profile unlocks

Building and Running

From the repository root:

cargo build

To make the local debug build available as invar in your current terminal, source the helper script:

source scripts/add-local-invar-to-path.sh

Building for Releases

Release build:

cargo build --release

Run without installing:

cargo run -- --help
cargo run -- --ping
cargo run -- --profile api-dev -- env

Testing

Run the full test suite:

cargo test --locked

Contributing

You may open up a pull request in GitHub with contributions to the CLI script.