Skip to content
Try Ditto free
Documentation

Start typing to search...
Updated November 10, 2026

Install the Ditto Plugin

Add the official Ditto marketplace, install the plugin in your AI client, and connect memory for the start and end of a task.

The Ditto plugin brings memory and skills into your AI client. Choose your client below, install Ditto, then sign in to your Ditto account when the client prompts you. The plugin connects to https://api.heyditto.ai/mcp through the client’s own OAuth sign-in. You do not need API keys, npm helpers, or a separate Ditto CLI setup.

Adding the marketplace alone does not install the plugin. A marketplace is a catalog. You still need to select and install Ditto from it, enable the plugin, and connect your account.

The official repository is ditto-assistant/ditto-plugins. Client availability and organization policies can vary. These instructions follow its current installation guide.

Claude Desktop, Chat, and Cowork

  1. Install Claude Desktop, or open claude.ai. Sign in to the Claude account and workspace where you want to use Ditto. The plugin follows your Claude account.
  2. In Desktop, select Chat or Cowork first. In the sidebar, open Customize → Plugins. Some accounts show Plugins directly.
  3. Select Add → Add marketplace → Add from a repository. Enter https://github.com/ditto-assistant/ditto-plugins, then sync or add the marketplace.
  4. Find Ditto in that marketplace and select Add. Enable it if prompted.
  5. Open the installed plugin and connect or sign in to Ditto. Under Yours, confirm Ditto is enabled, Connectors shows Ditto Connected, and Skills lists ditto-memory, handoff, weekly-review, and the other Ditto skills.
  6. Start a new chat, type /, and look for the Ditto skills before sending your request.

A Ditto plugin installed in Claude Code is a separate installation; it does not mean Ditto is installed in Chat. If the marketplace or plugin is unavailable, ask your Claude organization owner to check plugin policy.

Other work connectors are optional. After connecting Ditto, you can attach the host’s own connectors for the services you want to use; they are not required to install Ditto.

Claude Code

Run these inside Claude Code:

/plugin marketplace add ditto-assistant/ditto-plugins
/plugin install ditto@ditto-claude-plugins

Open /mcp to inspect and authenticate the plugin-provided Ditto server. The marketplace keeps its historical name, ditto-claude-plugins, even though the GitHub repository is now ditto-plugins.

To update an existing installation:

/plugin marketplace update ditto-claude-plugins
/plugin update ditto@ditto-claude-plugins
/reload-plugins

Cursor

Sign in to Cursor before running this in your terminal. Use the full URL; the owner/repo shorthand is rejected:

agent plugin marketplace add https://github.com/ditto-assistant/ditto-plugins

Then select and install Ditto from the added marketplace for your user or project. Teams can import the repository through Dashboard → Plugins & MCPs → Add Marketplace → Import from Repo. If Ditto is available in your Cursor Marketplace, you can also find it under Customize and install it there; directory availability is separate from repository installation.

Sign in to Ditto under Customize → MCP servers. Skills load under Agent Decides and can be invoked by name, such as /ditto-memory.

Codex

Run in your terminal:

codex plugin marketplace add ditto-assistant/ditto-plugins
codex plugin add ditto@ditto-plugins

Alternatively, install Ditto from /plugins. Complete the sign-in prompt, then check the connection in /mcp.

Grok Build

Run in your terminal:

grok plugin marketplace add ditto-assistant/ditto-plugins
grok plugin install ditto --trust

Plugins need trust to attach their MCP server. Check Ditto in /mcps and sign in when prompted. Skills appear as /ditto:<skill>, for example /ditto:ditto-memory.

GitHub Copilot CLI and VS Code

Run in your terminal:

copilot plugin marketplace add ditto-assistant/ditto-plugins
copilot plugin install ditto@ditto-plugins

In Copilot CLI, use /mcp to connect. In VS Code, add the marketplace repository from the agent plugins view, install Ditto, then start and sign in to the Ditto server from the MCP servers view.

Antigravity

Run in your terminal:

agy plugin install https://github.com/ditto-assistant/ditto-plugins

Sign in through the MCP servers panel when prompted. Gemini CLI is not supported by this plugin; use Antigravity instead.

Kimi Code

Run inside a Kimi Code session:

/plugins install https://github.com/ditto-assistant/ditto-plugins

Choose Trust and install, then run /reload. Check /plugins list: Ditto should have its skills and one MCP server. Open /mcp, then authenticate with:

/mcp-config login plugin-ditto:ditto

ChatGPT availability

The repository currently describes ChatGPT directory installation as available once listed. This guide does not confirm a live directory listing. See the repository’s ChatGPT notes for current packaging and listing information; those maintainer steps are not a user installation flow.

For the separate custom-connector route, use Ditto MCP Server. A custom MCP connector and a marketplace plugin are different setup paths.

Recall at the start, hand off at the end

There are no lifecycle hooks to configure in the current marketplace plugin. It does not inject context on every prompt or automatically save transcripts. Memory moves through skills and the hosted MCP connection, within your permissions.

  • At the start of work or an automation: invoke ditto-memory and ask it to recall relevant context. For example: “Use ditto-memory to find the latest decisions and open work for this project. Fetch the memories you rely on before starting.” Use your host’s skill menu or invoke the skill by name.
  • As work progresses: ask for a private save, or authorize ongoing private capture for the task. The skill records useful facts and decisions rather than every exchange. It does not enable automatic capture by itself.
  • When finishing or archiving a task: invoke handoff to save verified outcomes, constraints, open work, links, and the next step. Ask it to save the note and read it back. Archiving depends on host support; a saved memory does not prove the chat was archived.

For recurring automations, include these recall and save instructions in the automation’s task instructions. Installing the plugin alone does not schedule them or guarantee that every session will run them.

See Make Ditto Part of Your AI Workflow for a reusable instruction and Agent Integrations for other connection paths.

Check your setup

Start a new conversation and ask: “Use ditto-memory to search for relevant existing context. Report connection or permission errors; do not save a test memory.” Confirm the client actually uses Ditto and reports any errors. Seeing skills in a menu proves they loaded, not that memory access succeeded.

If skills are missing, check that you installed and enabled Ditto after adding the marketplace, then reload plugins or open a new conversation. If the server needs authentication, reconnect through the client’s MCP or connector controls using the intended Ditto account. For help, contact support@heyditto.ai with the client name and error message, without credentials.