Documentation

The reference for Earshot — voice-first feedback widget. Designed for humans, built for agents. Every page is also available as raw markdown — append /raw.md to any URL.

Quickstart
Install Earshot in under 5 minutes (human or agent-driven).
Concepts
Projects, feedback, sessions, federation, trackers.
Widget
Install snippet, Earshot.init options, identify / reset / open, capture model.
Cursor
Connect Cursor to the Earshot MCP and let Cursor install the widget into your app.
Dashboard
Inbox, detail page, status workflow, comments, project switcher.
Integrations
Federation (PostHog / Sentry / LogRocket / Datadog) and trackers (Linear / Jira). Security model + setup.
Project context
Push a brief about your app so the enrichment LLM reasons about real routes, glossary, and known issues.
MCP
Hosted MCP server with OAuth 2.1 DCR. 17 tools — feedback, project context, integrations, user-scoped admin.
REST API
/v1/feedback, /v1/identify, PATCH, comments. Authn via x-earshot-key.
Security
Auth model, encryption at rest, RLS, data handling, privacy choices.
Self-hosting
Run Earshot against your own Supabase + Vercel. Env vars, migrations, local dev.
Agents
Why Earshot treats agents as a first-class persona, and what that means in practice.