Connect an AI agent
Heedit names connection states precisely. Appearing as an annotation target is not the same as having a verified installer or a live session.
Current connection levels
| Agent | Direct setup | What works today |
|---|---|---|
| Claude Code | Built in | One-shot setup of MCP, the Heedit Skill and annotation hooks from Heedit or the CLI; annotations arrive in real time once the session is armed. |
| Codex | Built in | Same as above; the hooks take effect after restarting the Codex session and trusting them with /hooks. |
| Other Agents | Not built in | Connect by pasting the MCP snippet (the agent fetches annotations itself), or use AI Inbox, Finder, drag and drop, file paths and the copied output convention. |
Use the file workflow
If direct setup is unavailable, copy the Agent output convention from Heedit. It identifies the AI Inbox and asks the Agent to update an existing deliverable when appropriate instead of creating unexplained copies. You can also drag the real file to an Agent window or copy its path and delivery note.