Installation¶

Melliza is distributed as a single binary with no runtime dependencies. Choose your preferred installation method below.

Prerequisites¶

Before installing Melliza, ensure you have Gemini CLI installed and authenticated:

code-group

```bash [npm (recommended)]

Install Gemini CLI globally¶

npm install -g @google/gemini-cli

Authenticate (opens browser)¶

gemini login

```bash [npx (no install)]
# Run directly without installing
npx @google/gemini-cli login

Run gemini --version to confirm Gemini CLI is installed. Melliza will not work without it.

Optional: GitHub CLI (gh)¶

If you want Melliza to automatically create pull requests when a PRD completes, install the GitHub CLI:

# macOS
brew install gh

# Linux
# See https://github.com/cli/cli/blob/trunk/docs/install_linux.md

# Authenticate
gh auth login

The gh CLI is only required for automatic PR creation. All other features work without it.

Homebrew (Recommended)¶

The easiest way to install Melliza on macOS or Linux:

brew install lvcoi/melliza/melliza

This method: - Automatically handles updates via brew upgrade - Installs to /opt/homebrew/bin/melliza (Apple Silicon) or /usr/local/bin/melliza (Intel/Linux) - Works on macOS (Apple Silicon and Intel) and Linux (x64 and ARM64)

Updating¶

The easiest way to update is Melliza's built-in update command, which works regardless of how you installed:

melliza update

If you installed via Homebrew, you can also use:

brew update && brew upgrade melliza

Melliza automatically checks for updates on startup and notifies you when a new version is available.

Install Script¶

Download and install with a single command:

curl -fsSL https://raw.githubusercontent.com/lvcoi/melliza/main/install.sh | bash

The script automatically detects your platform and downloads the appropriate binary.

Script Options¶

Examples:

# Install a specific version
curl -fsSL https://raw.githubusercontent.com/lvcoi/melliza/main/install.sh | bash -s -- --version v0.1.0

# Install to a custom directory
curl -fsSL https://raw.githubusercontent.com/lvcoi/melliza/main/install.sh | bash -s -- --dir ~/.local/bin

# Both options combined
curl -fsSL https://raw.githubusercontent.com/lvcoi/melliza/main/install.sh | bash -s -- --version v0.1.0 --dir /opt/melliza

If you install to a custom directory, make sure it's in your PATH:

export PATH="$HOME/.local/bin:$PATH"

Manual Binary Download¶

Download the binary for your platform from the GitHub Releases page.

Platform Matrix¶

Installation Steps¶

code-group

```bash [macOS Apple Silicon]

Download the binary¶

curl -LO https://github.com/lvcoi/melliza/releases/latest/download/melliza-darwin-arm64

Make it executable¶

chmod +x melliza-darwin-arm64

Move to a directory in your PATH¶

sudo mv melliza-darwin-arm64 /usr/local/bin/melliza

```bash [macOS Intel]
# Download the binary
curl -LO https://github.com/lvcoi/melliza/releases/latest/download/melliza-darwin-amd64

# Make it executable
chmod +x melliza-darwin-amd64

# Move to a directory in your PATH
sudo mv melliza-darwin-amd64 /usr/local/bin/melliza

```bash [Linux x64]

Download the binary¶

curl -LO https://github.com/lvcoi/melliza/releases/latest/download/melliza-linux-amd64

Make it executable¶

chmod +x melliza-linux-amd64

Move to a directory in your PATH¶

sudo mv melliza-linux-amd64 /usr/local/bin/melliza

```bash [Linux ARM64]
# Download the binary
curl -LO https://github.com/lvcoi/melliza/releases/latest/download/melliza-linux-arm64

# Make it executable
chmod +x melliza-linux-arm64

# Move to a directory in your PATH
sudo mv melliza-linux-arm64 /usr/local/bin/melliza

Not sure which binary you need? Run these commands:

# macOS
uname -m  # arm64 = Apple Silicon, x86_64 = Intel

# Linux
uname -m  # x86_64 = AMD64, aarch64 = ARM64

Building from Source¶

Build Melliza from source if you want the latest development version or need to customize the build.

Prerequisites¶

• Go 1.21 or later (install Go)
• Git for cloning the repository

Build Steps¶

# Clone the repository
git clone https://github.com/lvcoi/melliza.git
cd melliza

# Build the binary
go build -o melliza ./cmd/melliza

# Optionally install to your GOPATH/bin
go install ./cmd/melliza

Build with Version Info¶

For a release-quality build with version information embedded:

go build -ldflags "-X main.version=$(git describe --tags --always)" -o melliza ./cmd/melliza

Verify the Build¶

./melliza --version

Verifying Installation¶

After installing via any method, verify Melliza is working correctly:

# Check the version
melliza --version

# View help
melliza --help

# Check that Gemini CLI is accessible
gemini --version

Expected output:

If melliza is not found after installation: 1. Check that the installation directory is in your PATH 2. Open a new terminal window/tab to reload your shell 3. Run which melliza to see if it's found and where

See the Troubleshooting Guide for more help.

Next Steps¶

Now that Melliza is installed:

1. Quick Start Guide - Get running with your first PRD
2. How Melliza Works - Understand the autonomous agent concept
3. CLI Reference - Explore all available commands