heresay

Connect a repo to your Heresay, so coding agents can install it in your app and fix the reports your team accepts.

npx heresay connect

Run it in the app's repo. It opens your Heresay dashboard to make a token for this repo, then adds files you commit:

• .mcp.json: the Heresay MCP server (npx heresay@latest mcp)
• .claude/skills/heresay/SKILL.md: a short skill with the rules
• a Heresay section in AGENTS.md, for agents without MCP

The token stays in ~/.heresay/connections.json, never in the repo. Then ask your agent "Add Heresay to this app" or "Fix the next Heresay report".

What the agent can do

MCP tools: heresay_guide, list_apps, create_app, install_guide, check_install, list_briefs, get_brief, claim_brief, add_note, handoff, mark_fixed.

It sees accepted reports for this repo's apps only. It can't see open reports, and it can't accept or decline: people do that. Report text always arrives fenced as a user's description, never as instructions.

Without MCP

npx heresay briefs                 # accepted reports routed to this repo
npx heresay claim <id>
npx heresay brief <id>
npx heresay fixed <id> "Export now downloads a CSV."
npx heresay guide fix-brief

npx heresay connect --update refreshes the skill when a new version ships. Setting up a Heresay itself is npx create-heresay.