join-meeting

join-meeting

IMPORTANT: Read this entire document before joining a meeting. This file contains the CALL_LOOP algorithm (mandatory), active participation rules, safety requirements (leave/cleanup), and mode-specific guidance. Skipping sections will result in broken meeting experiences — the user will be left talking to silence.

IMPORTANT: Read the whole document on every session, not just the parts you remember. This skill is updated frequently — new commands, new events, new recommended patterns (like the event-driven tail -f + Monitor flow in "How to read events") are added often. Do NOT rely on what you remember from previous sessions. Re-read this document each time you start a meeting so you pick up the latest guidance. If unsure whether you are on the latest version, run python scripts/python/check_update.py (see "Checking for Skill Updates").

Join a video meeting as an AI bot with voice and visual presence.

Prerequisites

• Python 3.10+ (preferred) or Node.js 18+
• Python dependencies: pip install aiohttp websockets
• Node.js dependencies: cd scripts/node && npm install
• For webpage modes: a local HTTP server running on the specified port

API Key Setup

Before joining a meeting, make sure an API key is configured:

1. Check ~/.agentcall/config.json — if it exists and has api_key, you're ready.

2. Check AGENTCALL_API_KEY env var — if set, you're ready.

3. If neither exists, get a key one of two ways:

   Option A — Self-register via email (no dashboard, no human hand-off needed). AgentCall accounts are created with a 6-digit email code. New accounts include free trial credits (base plan, 360 minutes), so the first call works immediately.

   # 1. Request a code. Use the user's email, or — if you can read your own
   #    mailbox — an address you have access to:
   python scripts/python/register.py send --email [email protected]
   
   # 2. Get the 6-digit code from that inbox. If you can read the mailbox yourself,
   #    retrieve it directly; otherwise ask the user to paste it. Codes expire in
   #    10 minutes; a resend is allowed after 60 seconds.
   
   # 3. Verify the code. This mints an API key named "AgentCall Skill on <hostname>"
   #    and saves it to ~/.agentcall/config.json:
   python scripts/python/register.py verify --email [email protected] --code 123456
   

   Node equivalent: node scripts/node/register.js send --email ... and node scripts/node/register.js verify --email ... --code .... Both scripts use only the language standard library, so they run before pip install / npm install.