Mezmo CLI

Caution

This application is still considered "beta". Its interfaces and/or its stability is subject to change in breaking ways

Features

Available Commands

Subcommands

Log Commands

Get Commands

Config Commands

Create Commands

Edit Commands

Delete Commands

Prerequisites

Environment Variables

System Access Requirements

File System Access

Network Access

Process Permissions

Security Considerations

Installation

Option 1: Download Pre-compiled Binary (Recommended)

# macOS (Apple Silicon)
curl -LO https://github.com/mezmo/cli/releases/latest/download/mzm-darwin-aarch64
chmod +x mzm-darwin-aarch64
sudo mv mzm-darwin-aarch64 /usr/local/bin/mzm
# macOS (Intel)
curl -LO https://github.com/mezmo/cli/releases/latest/download/mzm-darwin-x86_64
chmod +x mzm-darwin-x86_64
sudo mv mzm-darwin-x86_64 /usr/local/bin/mzm
# Linux (x86_64)
curl -LO https://github.com/mezmo/cli/releases/latest/download/mzm-linux-x86_64
chmod +x mzm-linux-x86_64
sudo mv mzm-linux-x86_64 /usr/local/bin/mzm
# Linux (ARM64)
curl -LO https://github.com/mezmo/cli/releases/latest/download/mzm-linux-aarch64
chmod +x mzm-linux-aarch64
sudo mv mzm-linux-aarch64 /usr/local/bin/mzm
# Windows
# Download mzm-windows-x86_64.exe and add to PATH

Option 2: Build from Source

# Clone the repository
git clone https://github.com/mezmo/cli.git
cd cli
# Install Deno if not already installed
curl -fsSL https://deno.land/install.sh | sh
# Compile the CLI for your platform
deno task compile:local
# Move binary to PATH
sudo mv mzm /usr/local/bin/

Option 3: Run with Deno (Development)

# Clone the repository
git clone https://github.com/mezmo/cli.git
cd cli
# Run directly with Deno
deno task local <command> [options]

Configuration

Initial Setup

# Set the access key for your current session
export MZM_ACCESS_KEY="your-access-key-here"

Shell Completions

# Bash
source <(mzm completions bash)
# Zsh
source <(mzm completions zsh)
# Fish
source (mzm completions fish | psub)

Usage

Getting Help

# display help text for the main command
mzm
# display help for the log command
mzm log --help
# display help text for the log search command
mzm log search --help

Working with Logs

# Basic search
mzm log search "error"
# Search with time range
mzm log search "database connection" --from "1h ago" --to "now"
# Search with filters
mzm log search "error" --app myapp --level error
# Export results
mzm log search "critical" --format json > results.json

# Tail all logs
mzm log tail
# Tail with filters
mzm log tail --app production --level warn --leve error
# Tail specific hosts
mzm log tail --host server1 --host server2
# Tail with custom query
mzm log tail "status:500"

Managing Views

# List all views
mzm get view
# Get specific view details
mzm get view <view-id>
# Output as JSON
mzm get view --output json

# Create from YAML file
cat > view.yaml << EOF
---
version: v1
resource: view
metadata: {}
spec:
 name: production-errors
 query: level:error AND app:production
 category:
 - production
 - errors
EOF
mzm create -f view.yaml

# Edit view interactively
mzm edit view <view-id>
mzm edit view "name of a view"

# Delete a view
mzm delete view <view-id>

AI Assistant

# Ask a question
mzm ask "How do I filter logs by timestamp?"
# Continue a previous conversation
mzm ask --continue
# Continue specific conversation
mzm ask --continue <conversation-id>
# Interactive mode
mzm ask
# Then type your questions interactively

Resource Management

# Create resources from file
mzm create -f resource.yaml
# Delete resources from spec file (experimental)
mzm delete -f resource.yaml
# Delete a view by id
mzm delete view a41febfd
# Delete a view name
mzm delete view "my view name"

---
version: v1
resource: view
metadata: {}
spec:
 name: application-logs
 query: app:myapp
 category:
 - application
---

Examples

Complex Log Queries

# Search for errors in production from the last hour
mzm log search "level:error AND env:production" --from "1h ago"
# Tail logs with multiple filters
mzm log tail --app api --level error --level warn --host prod-* "level:error AND env:production"

Batch Operations

# Create multiple views from a directory
for file in views/*.yaml; do
 mzm create -f "$file"
done
# Export all views
mzm get view --output json > all-views.json

Automation Scripts

#!/bin/bash
# Monitor for critical errors
mzm log tail --level critical --format json | while read -r line; do
 # Process each critical log
 echo "Critical error detected: $line"
 # Send alert, create ticket, etc.
done

Development

Prerequisites

Setup Development Environment

# Clone repository
git clone https://github.com/mezmo/cli.git
cd cli
# Install dependencies (Deno downloads automatically)
deno cache main.ts
# Run tests
deno task test
# Generate coverage reports
deno task reports
# Run locally with environment variables
deno task local <command>

Building

# Build all platforms
deno task compile
# Build specific platform
deno task compile:linux:x86
deno task compile:osx:arm
deno task compile:windows
# Build for local testing
deno task compile:local

# Run all tests
deno task test
# Run with coverage
deno task reports
# Run specific test file
deno test @mzm/core/error.test.ts

License

Support

Contributing

Contributors ✨