Quick Start
1
Add the plugin
Open Connect apps in the Bot sidebar, search for Honcho, and choose Add. Or open the Honcho plugin page from the Cursor Marketplace listing and choose Add to Grok Bot. The install is account-wide: every Bot can use it.
2
Sign in
Tell any Bot: “Set up Honcho.” It shows a connect card; complete the sign-in in your browser. If you do not have a Honcho account yet, create one at app.honcho.dev first. No API key is pasted anywhere.
3
Answer two questions
The Bot runs the
honcho-setup skill and asks whether Honcho’s memory of you should be shared with another tool (for example Claude Code or Cursor) and what Honcho should call you. It stores the answers in Honcho’s workspace metadata. Every other Bot on the account reads them on its first conversation and asks you nothing.How Bots Use It
- Recall first. At the start of a conversation the Bot reads what Honcho knows about you and acts on it. When a specific question would help, it asks Honcho and gets a reasoned answer.
- Record every turn. Grok Bot runs no lifecycle hooks, so the
honcho-grok-botskill tells the Bot to append your message and its reply at the end of each turn. Secrets are replaced with[redacted]; raw tool output is never recorded. - Durable facts right away. When you state a preference, the Bot stores it as a conclusion so it is available before background reasoning catches up.
How Memory Is Organized
You are one peer everywhere, so what one Bot learns about you is available to all of them. Each Bot is its own peer, so Honcho can also tell you what a particular Bot has been doing.
The plugin’s skills and the MCP server are the only parts that run in Grok Bot. The always-on rule, the
/recall command and the lifecycle hooks in the same plugin are for the Cursor IDE and are ignored by Bots.Connecting Without the Plugin
A Bot can also add Honcho as a custom MCP connector athttps://mcp.honcho.dev with an Authorization: Bearer <api-key> header. That gives it the tools without the skills, so you will need to tell it how to name peers and sessions. If the Bot wires the connector through mcp-remote on its own computer, ask it to also send a User-Agent header naming the Bot, so usage is attributed to it rather than to a generic client.
Troubleshooting
The Bot reports an authentication error. Say “Sign in to Honcho again.” Tokens refresh on their own after the first sign-in; a revoked grant needs a new one. Two Bots describe you differently. They resolved different workspaces or handles. Ask each to run Honcho setup and give the same answers. The shared values live in thecursor workspace’s metadata.
A Bot stopped recording. Ask it to check the current session with Honcho’s search. Recording is skill-driven, so a Bot that was interrupted mid-turn may have skipped it; the next turn records normally.
Source
The plugin lives in the Honcho monorepo underintegrations/cursor/. Issues and pull requests go to plastic-labs/honcho.