Multisage

The multisage CLI must be installed globally:

npm install -g multisage

An API key is required. Get one at https://multisage.ai/settings (under "API Keys").

API Key Setup (Do This First)

Before running any multisage command, you must ensure MULTISAGE_API_KEY is available in your shell. The env var is often NOT inherited automatically — check and load it explicitly:

# 1. Check if it's already set
echo "${MULTISAGE_API_KEY:0:8}"
2. If empty, look for it in common locations
grep MULTISAGE_API_KEY .env 2>/dev/null || grep MULTISAGE_API_KEY ~/.env 2>/dev/null
3. Export it (replace with actual key found above)
export MULTISAGE_API_KEY="msk_..."

If you get a timeout or authentication error, the most likely cause is a missing API key — always verify it's set before debugging further.

Timeout errors are almost always caused by a missing API key — the CLI makes an unauthenticated request that hangs instead of returning a clean error. Fix: verify MULTISAGE_API_KEY is exported (see API Key Setup above).

Diagnostic checklist (run these before retrying):

# Is the API key set?
[ -n "$MULTISAGE_API_KEY" ] && echo "Key set: ${MULTISAGE_API_KEY:0:8}..." || echo "KEY NOT SET"
Is the CLI installed?
which multisage && multisage -V
Quick connectivity test
multisage -q "hello" > /tmp/ms-test.txt 2>&1 && echo "OK" || echo "FAILED — check output:" && cat /tmp/ms-test.txt