Ghostmeet — AI Meeting Assistant

Control ghostmeet from chat. Self-hosted meeting transcription with Whisper + AI summaries.

Prerequisites

ghostmeet backend must be running (Docker):

CODEBLOCK0

Chrome Extension must be installed in developer mode from extension/ folder.

Default backend: INLINECODE1

What This Skill Can Do

• - List sessions → query recorded meeting sessions
• Fetch transcripts → retrieve full text from a session
• Generate summaries → trigger AI summary via Claude API (requires GHOSTMEET_ANTHROPIC_KEY)
• Health check → verify backend is running

What This Skill Cannot Do

• - Start/stop recording → must be done manually via the Chrome Extension
• Install the Chrome Extension → user must load it in developer mode from extension/ folder
• Access browser audio → only the Chrome Extension captures audio; this skill only reads API results

Required Environment Variables

• - GHOSTMEET_ANTHROPIC_KEY — required for AI summary generation. Without it, transcription still works but summaries will fail.

API Commands

Health Check

curl -s http://127.0.0.1:8877/api/health

List Sessions

curl -s http://127.0.0.1:8877/api/sessions

Get Transcript

curl -s http://127.0.0.1:8877/api/sessions/{session_id}/transcript

Generate Summary

curl -s -X POST http://127.0.0.1:8877/api/sessions/{session_id}/summarize

Get Summary

curl -s http://127.0.0.1:8877/api/sessions/{session_id}/summary

Workflow

During a Meeting

1. 1. User joins a meeting (Google Meet, Zoom, Teams) in Chrome
2. Clicks ghostmeet extension icon → side panel opens
3. Clicks "Start" → real-time transcription begins
4. Transcripts appear live in the side panel

After a Meeting

1. 1. List sessions → find the latest session ID
2. Get transcript → review what was discussed
3. Generate summary → extract key points
4. Deliver summary to user

Example Interaction

User: "What was discussed in my last meeting?"
→ curl http://127.0.0.1:8877/api/sessions → get latest session
→ curl http://127.0.0.1:8877/api/sessions/{id}/transcript → get transcript
→ Summarize key points for the user

User: "Generate a summary with action items"
→ curl -X POST http://127.0.0.1:8877/api/sessions/{id}/summarize
→ curl http://127.0.0.1:8877/api/sessions/{id}/summary
→ Deliver formatted summary

User: "How many meetings did I have today?"
→ curl http://127.0.0.1:8877/api/sessions → count today's sessions

Configuration

Model Size Guide

• - tiny (75MB): Fast, lower accuracy. Good for quick notes
• base (145MB): Balanced. Recommended for most users
• small (488MB): Better accuracy, slower
• medium (1.5GB): High accuracy, needs good CPU/GPU
• large-v3 (3GB): Best accuracy, requires GPU

Usage Guidelines

1. 1. Always check health first — verify backend is running before other commands
2. List sessions to find IDs — session IDs are date-based (e.g., 20260308-065021)
3. Summarize only when asked — summary generation costs API tokens
4. Format transcripts nicely — don't dump raw JSON, present as readable conversation
5. Respect privacy — meeting transcripts are sensitive. Never share outside the current chat
6. If backend is down — suggest docker compose up -d in the ghostmeet directory

Privacy

• - Transcription is 100% local — Whisper runs on your machine, audio never leaves your device
• Summaries use Anthropic API — when you click Summarize, transcript text is sent to Claude API. If you don't want this, skip the summarize feature; transcription works without it
• Chrome Extension captures tab audio only — uses chrome.tabCapture API, limited to the active tab. It cannot access other tabs, microphone, or system audio. Audit the extension source in extension/ before installing
• No telemetry — ghostmeet sends zero analytics or tracking data

Troubleshooting

• - Connection refused → Backend not running. INLINECODE26
• No sessions → No meetings recorded yet. Chrome Extension must be active during meeting
• Summary fails → GHOSTMEET_ANTHROPIC_KEY not set in INLINECODE28
• Poor transcription → Try larger Whisper model or set explicit language