Samograph

samograph

Build agents that show up to the meeting, not just the codebase.

samograph lets your AI agent (Claude Code, Codex, and others) join Zoom and Google Meet calls as an active participant — listening, responding, and taking action in real time.

Give this CLI, a meeting URL, and the needed tokens to your AI agent. samograph handles the meeting plumbing through Recall.ai: joining calls, streaming the live transcript, sending explicit chat messages, and inspecting the current call view on demand.

Setup

Requirements:

• Bun.
• RECALL_API_KEY.
• ngrok installed and authenticated (free plan is enough for transcription; the presence camera needs an interstitial-free tunnel — see Dynamic Bot Presence). join starts and manages ngrok automatically — you don't run it yourself. ngrok is optional when using --webhook-base with an external tunnel (localtunnel, cloudflared, etc.).

Install the CLI from npm:

npm install -g samograph
export RECALL_API_KEY=...
samograph join "https://meet.google.com/..." --name Leo

During development use `bun install`, `bun run build`, then `bun run samograph ...`.

What It Provides

samograph gives an AI agent a small set of meeting tools:

• join - bring a Recall.ai bot into a Zoom or Google Meet call.
• watch - stream live transcript lines to the agent.
• notes - maintain a structured Google Doc agenda with important points, decisions, and action items.
• chat - send a deliberate message into the meeting chat (plays a soft chime into the call audio so people notice it).
• intro - post a short self-introduction into the meeting chat (also available as join --intro).
• presence - update the bot camera state shown in the meeting.
• frame - export the current call view on demand.
• leave - remove the bot and clean up local state.
• status - show the current Recall bot state.
• transcript - print the