Homebrew Tap for MeshGuard CLI

The official Homebrew tap for MeshGuard CLI — a command-line interface for managing your MeshGuard API gateway.

Installation

brew tap meshguard/meshguard
brew install meshguard

Dependencies

MeshGuard CLI requires jq for JSON processing. Homebrew will install it automatically, but if you're using the script standalone:

brew install jq

Quick Start

# Run the setup wizard
meshguard init

# Check gateway health
meshguard status

# List agents
meshguard agents list

# Create a new agent
meshguard agents create my-agent

# View audit logs
meshguard audit --limit 20

Configuration

MeshGuard CLI stores its configuration in ~/.meshguard/config.json. You can also use environment variables:

Variable	Description
MESHGUARD_URL	Gateway base URL (e.g., https://api.meshguard.io)
MESHGUARD_API_KEY	API key for authentication
MESHGUARD_ADMIN_TOKEN	Admin token for privileged operations

Environment variables take precedence over the config file.

Commands

Command	Description
meshguard init	Interactive setup wizard
meshguard status	Check gateway health
meshguard agents list	List all agents
meshguard agents create <name>	Create a new agent
meshguard agents delete <id>	Delete an agent by ID
meshguard policies list	List all policies
meshguard policies get <id>	Get policy details
meshguard audit	Query audit logs
meshguard signup	Interactive signup flow
meshguard version	Show CLI version
meshguard help	Show help

Use meshguard <command> --help for detailed usage of any command.

Updating

brew update
brew upgrade meshguard

Uninstalling

brew uninstall meshguard
brew untap meshguard/meshguard

Shell Completions

Completions for Bash and Zsh are installed automatically by Homebrew.

Bash — Add to your ~/.bashrc:

source $(brew --prefix)/etc/bash_completion.d/meshguard

Zsh — Completions are linked into Homebrew's site-functions automatically.

License

MIT License — see LICENSE for details.