Installation

Use the hosted installer to download the current release for your platform. No Node.js runtime is required.

Install

curl -fsSL https://www.mogplex.com/install.sh | sh

iwr -useb https://www.mogplex.com/install.ps1 | iex

What the installer changes

The installer downloads the current release archive, extracts the mogplex binary, and installs it into the Mogplex home bin directory:

• macOS and Linux: ~/.mogplex/bin/mogplex
• Windows: %USERPROFILE%\.mogplex\bin\mogplex.exe

It then tries to make mogplex runnable immediately:

• on macOS and Linux it first tries to link mogplex into a writable directory already on your PATH
• if that is not possible, it updates your shell profile or prints the export command
• on Windows it updates the user PATH for future PowerShell sessions

If you want a different install location, set MOGPLEX_INSTALL_DIR before running the installer.

Installer environment variables

• MOGPLEX_INSTALL_DIR — override the install location.
• MOGPLEX_VERSION — pin to a specific release instead of the latest.
• MOGPLEX_BASE_URL — override the manifest host (must be HTTPS).

Examples:

MOGPLEX_INSTALL_DIR="$HOME/.local/bin" \
  curl -fsSL https://www.mogplex.com/install.sh | sh

MOGPLEX_VERSION=0.2.0 \
  curl -fsSL https://www.mogplex.com/install.sh | sh

Verify the install

mogplex --version

If your current shell still does not see it, run:

rehash
# or
exec zsh -l

First run

mogplex

The first launch opens the in-app login screen. Sign in with your Mogplex account. Mogplex never requires environment variables for normal use.

For the full first-run flow, continue with Quickstart.

Upgrade

Re-run the installer. It detects the existing install and replaces the binary in place.

Troubleshooting

• mogplex: command not found — the install succeeded but your shell has not picked up the updated PATH. Rehash or open a new shell.
• The installer downloads but fails before extraction — confirm your machine has the right extractor (tar for .tar.gz, unzip or ditto for .zip).
• You pinned MOGPLEX_BASE_URL and the script exits immediately — the installer rejects non-HTTPS hosts.
• Login succeeds but prompts fail — your account probably lacks model access. Check Available Models and Plans & Billing.

Uninstall

Delete the mogplex binary from the location the installer reported. Local state in ~/.mogplex/ is left untouched.

Remove that directory too if you want to clear config, auth, logs, permissions, and other local state.