Meeting Context Hub

TUI tool for managing meeting contexts with AI extraction and semantic chaining

Why This Exists

When working on multiple parallel workstreams (squads, teams, personal projects), it becomes nearly impossible to retain all the granular discussions—policies, direction decisions, conventions, edge cases—that happen across meetings and conversations.

MCH captures what matters for development work and chains them together by relevance, so you can quickly rebuild context when switching between projects.

Features

• AI Extraction: Automatically extract decisions, action items, and policies from meeting notes
• Local Whisper: Free, offline speech-to-text using local Whisper model
• Semantic Search: Find related contexts using embedding-based similarity
• Context Chaining: Automatically link related discussions
• Project Organization: Group contexts by squad, team, or project

Requirements

| Requirement | macOS/Linux | Windows | |-------------|-------------|---------| | Node.js 20+ | ✅ | ✅ | | sox | ✅ | ✅ | | GNU Make | ❌ | ✅ Download |

Status

v2.0.0-alpha - Complete redesign in progress

See ROADMAP for implementation plan.

Quick Start

# Set API keys
export ANTHROPIC_API_KEY=sk-ant-xxx
export OPENAI_API_KEY=sk-xxx  # Optional: fallback for Whisper API

# Install dependencies
pnpm install

# Download Whisper model (first time only, ~142MB for base)
npx whisper-node download

# Run (TUI)
pnpm dev

Documentation

| Document | Description | |----------|-------------| | PRD | Product requirements | | Architecture | Technical design | | Roadmap | Implementation plan |

Configuration

# Required
ANTHROPIC_API_KEY=sk-ant-xxx   # Claude API (context extraction)

# Optional
OPENAI_API_KEY=sk-xxx          # OpenAI - Whisper API fallback & semantic search (Embedding)
MCH_DB_PATH=~/.mch/data.db     # Database location
MCH_LANGUAGE=en                # UI language: 'ko' or 'en' (default: 'en')
MCH_TRANSCRIPTION_MODE=auto    # 'local' | 'api' | 'auto' (default: 'auto')

Transcription Modes

| Mode | Description | |------|-------------| | local | Local Whisper only (free, offline) | | api | OpenAI Whisper API only | | auto | Local first, fallback to API on failure (default) |

Note: Local Whisper is used by default. OpenAI API key is only required for semantic search and API fallback.

Tech Stack

• UI: React + Ink (TUI)
• AI: Claude (extraction), OpenAI (embedding)
• Speech-to-Text: Local Whisper (whisper-node) / OpenAI Whisper API (fallback)
• Storage: SQLite
• Language: TypeScript

Development

# Clone
git clone https://github.com/mag123c/meeting-context-hub.git
cd meeting-context-hub

# Install
pnpm install

# Dev mode
pnpm dev

# Build
pnpm build

# Lint
pnpm lint

# Test
pnpm test

License

MIT