getting-started

MeetStream Getting Started — First-Time Setup

This skill is the mandatory Step 0 for any MeetStream integration. If the user doesn't have an account or API key, no other skill can succeed. Walk them through it before scaffolding anything.

When to invoke this skill

Always invoke this skill first if any of these are true:

1. The user explicitly says they're new to MeetStream / don't have an account
2. MEETSTREAM_API_KEY environment variable is missing
3. A different MeetStream skill (notetaker, sales-coach, calendar-automation, verify-account, test-bot) was invoked and the API key check failed
4. The user pastes an obviously-wrong API key (e.g. YOUR_API_KEY, ms_xxxxx, empty string)

Skip if:

• MEETSTREAM_API_KEY is set AND a quick ping to GET /bots returns 200
• The user explicitly says "I already have my key, just build X"

Step 1: Check if API key is already configured

# Quick check
if [ -z "$MEETSTREAM_API_KEY" ]; then
  echo "No API key set — starting onboarding"
else
  # Validate it
  STATUS=$(curl -s -o /dev/null -w "%{http_code}" \
    -H "Authorization: Token $MEETSTREAM_API_KEY" \
    "https://api.meetstream.ai/api/v1/bots")
  if [ "$STATUS" = "200" ]; then
    echo "✅ API key already valid — skipping onboarding"
    exit 0
  else
    echo "❌ API key set but invalid (HTTP $STATUS) — re-running onboarding"
  fi
fi

If invalid or missing, continue to Step 2.

Step 2: Sign up for a MeetStream account (if needed)

Tell the user:

You'll need a MeetStream account to use this. Free tier includes credits to
get you started — no credit card needed up front.

👉 Open https://app.meetstream.ai in your browser

  1. Sign up with your work email (Google sign-in works too)
  2. Confirm your email if prompted
  3. You'll land on the dashboard

Reply "done" when you're signed in and I'll walk you through the API key.

Wait for the user to confirm before continuing.

Step 3: Create an API key

Tell the user:

Now create an API key:

👉 Open https://app.meetstream.ai/api-keys

  1. Click "Create API Key" (or similar — top right of the page)
  2. Name it something memorable (e.g. "claude-code-dev")
  3. Copy the key — it starts with "ms_..."
  4. ⚠ Save it now — you usually can't view it again after closing the modal

Paste the key here when ready (I'll redact it from logs).

When the user pastes the key, do NOT echo it back. Acknowledge with just "Got it — key starts with ms_xxxx... (length: N chars)".

Step 4: Set the API key in their shell

Detect the user's shell + suggest the right persistence approach:

echo $SHELL  # /bin/zsh, /bin/bash, etc.

For zsh / bash users (most common)

# For this session only:
export MEETSTREAM_API_KEY=ms_xxxxx

# To persist across sessions (zsh):
echo 'export MEETSTREAM_API_KEY=ms_xxxxx' >> ~/.zshrc
source ~/.zshrc

# Or bash:
echo 'export MEETSTREAM_API_KEY=ms_xxxxx' >> ~/.bashrc
source ~/.bashrc

For project-scoped (.env) — recommended for application code

If the user is building an app (notetaker / coach / etc.), they'll also want it in .env:

# In the project root
echo "MEETSTREAM_API_KEY=ms_xxxxx" >> .env

# Make sure .env is gitignored
grep -q "^\.env$" .gitignore || echo ".env" >> .gitignore

Never commit .env to git. If the key leaks, rotate it immediately at https://app.meetstream.ai/api-keys.

Step 5: Validate the key

curl -s -o /dev/null -w "%{http_code}\n" \
  -H "Authorization: Token $MEETSTREAM_API_KEY" \
  "https://api.meetstream.ai/api/v1/bots"

Expected: 200.

If 401 or 403: key is wrong, re-do Step 3. If anything else: network issue, ask user to retry.

Step 6: Verify provider configuration (optional but recommended)

After a valid key, suggest:

✅ Your API key works.

One more recommended step: verify which transcription providers are configured
on your account. This catches "provider missing" errors before you build anything.

Run the `verify-account` skill, or I can run it now — want me to?

If yes, hand off to the verify-account skill.

Step 7: Suggest next action

Based on what the user originally wanted, route them:

User originally said	Hand off to
"build a notetaker"	notetaker skill
"build a sales coach"	sales-coach skill
"auto-record my calendar"	calendar-automation skill
"test a bot"	test-bot skill
"I just want to look around"	Suggest reading the meetstream core skill

If they didn't originally have a goal, suggest the most common starting point:

You're all set. Most users start with one of these:

  🎙️  AI Meeting Notetaker         → "build me an AI notetaker"
  🎯  Real-Time AI Sales Coach     → "build a real-time sales coach"
  📅  Calendar Auto-Recording      → "auto-record every meeting on my calendar"
  🧪  Just send a test bot         → "send a test bot to https://meet.google.com/..."

Which one?

Troubleshooting

"I see the dashboard but no 'Create API Key' button"

Direct them to https://app.meetstream.ai/api-keys (deep link). Account may need email verification first — check inbox.

"The key I created returns 401"

• Make sure they copied the WHOLE key (it's long — usually starts with ms_ then 30+ characters)
• Make sure there are no leading/trailing whitespace characters
• Make sure they exported it: echo $MEETSTREAM_API_KEY should print the key (not empty)

"I have no credits / billing question"

Direct to https://app.meetstream.ai → Billing section. Free tier covers a meaningful amount; paid plans at https://meetstream.ai/pricing.

"I want to use a team account / shared key"

• Each team member should create their own key from their own account
• For server-side production use, create a dedicated key (e.g. "production") and store in a secret manager (AWS Secrets Manager, Doppler, Vault)

"Can I rotate my key without breaking my deployment?"

• Create a new key first (don't delete the old one)
• Deploy the new key to your environment
• Once the new key is in use, delete the old one from the dashboard

Constraints

• Never log the API key value. Show only the first 4 + length when acknowledging.
• Never commit the key to git. Always insist on .env + .gitignore.
• Never POST the key anywhere except api.meetstream.ai.
• Never proceed with any build skill until Step 5 succeeds. Better to ask once more than to scaffold a broken app.