Navigation

Install the CLI

Install and configure the Aperture CLI

This guide covers how to install the Aperture CLI on your system.

The easiest way to install the Aperture CLI on macOS or Linux is via Homebrew:

# Add the tap
$ brew tap triptechdev/aperture-cli https://github.com/Triptechdev/aperture-cli


# Install
$ brew install aperture


# Verify installation
$ aperture --version

Direct Download

Download pre-built binaries for your platform:

macOS

Universal Binary (Apple Silicon & Intel):

$ curl -L https://github.com/triptechdev/aperture-cli/releases/latest/download/aperture-universal-apple-darwin.tar.gz | tar xz
$ sudo mv aperture-universal /usr/local/bin/aperture

Linux

x86_64:

$ curl -L https://github.com/triptechdev/aperture-cli/releases/latest/download/aperture-x86_64-unknown-linux-gnu.tar.gz | tar xz
$ sudo mv aperture /usr/local/bin/

ARM64:

$ curl -L https://github.com/triptechdev/aperture-cli/releases/latest/download/aperture-aarch64-unknown-linux-gnu.tar.gz | tar xz
$ sudo mv aperture /usr/local/bin/

Verify Installation

After installation via any method:

$ aperture --version

Release Verification

All releases include SHA256 checksums for verification:

# Download the checksums file
$ curl -LO https://github.com/triptechdev/aperture-cli/releases/latest/download/checksums.txt


# Verify (macOS)
$ shasum -a 256 -c checksums.txt


# Verify (Linux)
$ sha256sum -c checksums.txt

Configuration

After installation, the CLI stores its configuration in an XDG-compliant location:

  • macOS/Linux: ~/.config/aperture/config.json

The configuration file is created automatically when you first authenticate.

First-Time Setup

After installing the CLI, authenticate with your Aperture account:

# Interactive login (prompts for password)
$ aperture auth login --email your-email@example.com


# Or use a token
$ aperture auth login --token <YOUR_TOKEN>

After successful login, set your organization and project context:

# Interactive selection (recommended)
$ aperture context set-org
$ aperture context set-project


# Or specify directly
$ aperture context set-org your-org-slug
$ aperture context set-project your-project-slug

Verify your configuration:

$ aperture context show

Updates

To check for updates:

# Homebrew
$ brew update && brew outdated aperture


# Manual installation - check releases page
# https://github.com/triptechdev/aperture-cli/releases

Next Steps

Previous

Overview

Next

Use the CLI