Cloud Setup Guide

This guide walks you through setting up Massu AI Cloud — the optional cloud layer that adds sync, dashboards, and team features on top of the open-source core.

Prerequisites

• Massu AI core installed and running locally
• A Massu AI Cloud subscription (Cloud Pro or Cloud Team)
• Node.js 18 or later

Step 1: Create Your Cloud Account

1. Visit massu.ai/pricing and choose Cloud Pro or Cloud Team
2. Complete the checkout process
3. You'll receive a welcome email with your dashboard URL

Step 2: Generate an API Key

1. Log in to your Cloud dashboard
2. Navigate to Settings → API Keys
3. Click Generate New Key
4. Copy the key — you'll need it in the next step

Security note: Your API key should be stored securely and never committed to version control.

Step 3: Configure Local Sync

The recommended, git-safe way to register your key is massu login, which stores it in ~/.massu/credentials (outside every repository) so it is never committed:

npx massu login

Alternatively, export it as an environment variable:

export MASSU_API_KEY=your-api-key-here

Then enable cloud sync in your massu.config.yaml:

cloud:
  enabled: true
  sync:
    memory: true
    analytics: true
    audit: true

Do not put the env var name in the config as a placeholder. The loader does not expand shell-style ${VAR} placeholders — a dollar-brace apiKey value is stored as literal text, not your key. Provide the key via massu login or the MASSU_API_KEY env var instead. The cloud endpoint defaults to https://api.massu.ai/v1; you only need to set cloud.endpoint (or MASSU_CLOUD_ENDPOINT) for self-hosted or enterprise deployments.

Step 4: Verify the Connection

Confirm your key is picked up and your tier is resolved:

npx massu doctor
# Look for the License line, e.g.: "Pro (via ~/.massu/credentials)"

What Gets Synced

Step 5: Explore the Dashboard

Your Cloud dashboard provides:

• Session history — Browse past coding sessions with quality metrics
• Quality trends — Track improvement over time
• Cost tracking — Monitor AI API costs per feature
• Team activity (Cloud Team) — See what your team is working on

Troubleshooting

"Cloud sync failed: unauthorized"

Your API key may be expired or invalid. Generate a new one from the dashboard.

"Cloud sync failed: network error"

Check your internet connection. Cloud sync requires HTTPS access to api.massu.ai.

Data not appearing in dashboard

Sync runs automatically in the background as your sessions produce data. Wait for the next sync cycle, then refresh the dashboard.