Harmonica Chat

harmonica-chat

Design and manage [Harmonica](https://harmonica.chat) deliberation sessions from your coding agent. Guided session design, template matching across the live platform library, full lifecycle commands (check, summary, edit, review, follow-up), and post-session facilitation-quality analysis.

[Harmonica](https://app.harmonica.chat) is a structured-conversations platform where groups align via AI-facilitated async conversations. You create a session with a topic and goal, share a link with participants, and each person has a private 1:1 chat with an AI facilitator. Responses are then synthesized into actionable insights. [Learn more](https://help.harmonica.chat).

Unlike a one-shot session creator, harmonica-chat is a guided designer — it walks you through template selection, goal refinement, and context calibration, then handles the full lifecycle from creation through follow-up.

Works with

• Claude Code — fully supported today, via ~/.claude/skills/harmonica-chat/. Quick install below.
• Cursor, Codex, Grok Build, OpenCode, Pi agent, … — the skill is plain Markdown using the Agent Skills format. Manual install (copy SKILL.md + reference/ to the agent's skills directory) should work. OpenCode-specific MCP mapping is documented in `reference/opencode.md`; first-class installers for other harnesses are tracked in HAR-1231.

Prerequisites

• A Harmonica account — sign up free if you don't have one.
• An API key — generate at Profile > API Keys. You'll get a hm_live_... value.
• Node.js ≥18 on PATH (needed to run harmonica-mcp via npx).
• Claude Code on PATH (for the v3.1 installer; manual install works without it).

Installation

Quick inst