> ## Documentation Index
> Fetch the complete documentation index at: https://honcho.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Grok Bot

> Give your Grok Bots a shared memory of you

Grok Bots are always-on AI teammates with their own cloud computer. Each new task can start on a fresh machine with a blank context. The Honcho plugin gives every Bot on your account a shared, growing memory of you: your preferences, your decisions, and what each Bot was doing, carried across tasks, conversations, and Bots.

This is the same plugin as the [Cursor integration](https://honcho.dev/docs/v3/guides/integrations/cursor.md). A Bot uses two parts of it: the hosted Honcho MCP server and the skills. The plugin is designed to work from those two alone.

## Quick Start

**1. Add the plugin**

The plugin is not in the Cursor Marketplace yet, so it does not appear under **Connect apps**. Until it does, give any Bot the plugin's link and ask it to set Honcho up:

```text theme={null}
Set up Honcho memory using the plugin at https://github.com/plastic-labs/honcho/tree/main/integrations/cursor: connect its MCP server (https://mcp.honcho.dev, sign in with OAuth), install its skills, then run honcho-setup.
```

The Bot adds the Honcho MCP server and saves the plugin's skills. The setup is account-wide: every Bot can use it.

**2. Sign in**

The Bot 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](https://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.

To check it worked, start a new conversation with any Bot and ask what Honcho knows about you.

[Setting up Honcho in Grok Bot](https://www.youtube.com/embed/SpFLfYKMs1Q)

## 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-bot` skill 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

| Honcho concept | Value for Grok Bots |
| - | - |
| Workspace | `cursor`, or the shared workspace you picked during setup |
| User peer | one handle for you, shared by every Bot |
| Agent peer | one per Bot, the Bot's name in kebab-case |
| Session | `<bot>-conv-<id>` when a conversation id is available, otherwise `<bot>-chat-<date>` |
| Group chat | `group-<name>-<date>`, with you and every participating Bot as peers |
| Routine run | `<bot>-routine-<name>-<date>` |

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.

> [!NOTE]
>
> 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 at `https://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 the `cursor` 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 under [`integrations/cursor/`](https://github.com/plastic-labs/honcho/tree/main/integrations/cursor). Issues and pull requests go to [plastic-labs/honcho](https://github.com/plastic-labs/honcho).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.