{
  "markdown": "# GoodMem Claude Code Plugin\n\nA Claude Code plugin for [GoodMem](https://docs.goodmem.ai) — memory infrastructure for AI agents.\n\nWith this plugin, you can operate GoodMem's memory infrastructure in plain English — create and manage embedders, rerankers, and LLMs, ingest memories from files, base64 strings, and plain text, and build knowledge-powered agents for RAG and Deep Research. Also includes Python and Java SDK references for writing GoodMem code.\n\n## Use cases\n\n- **Deep Research agent** — Create an embedder and space, ingest research papers and documents, then ask complex questions that retrieve and synthesize information across your entire knowledge base.\n- **RAG pipeline** — Configure embedders, rerankers, and LLMs, store source materials as memories, and retrieve relevant context for answering questions.\n- **Self-improving support agent** — Ingest historical issue tickets and resolutions, search for solutions matching a new problem description, and iteratively store new discoveries and fixes as memories so future troubleshooting gets smarter over time.\n\n## Installation\n\n**From the community marketplace** (preferred):\n\n```\n/plugin marketplace add anthropics/claude-plugins-community\n/plugin install goodmem@claude-community\n```\n\n**From this repo** (fallback — use only if the community marketplace is unavailable):\n\n```\n/plugin marketplace add PAIR-Systems-Inc/goodmem-claude-code-plugin\n/plugin install goodmem@goodmem-plugins\n```\n\n## Configuration\n\n### What you need to configure\n\n**GoodMem credentials** (required):\n\n- `GOODMEM_BASE_URL` — GoodMem server URL (e.g., `https://your-server.example.com`)\n- `GOODMEM_API_KEY` — GoodMem API key (starts with `gm_`)\n\n**TLS / self-signed certificates** (optional):\n\nThis is an advanced topic. If you do not even know what that is, skip this section. \n\nIf the GoodMem server uses self-signed CA certificates, set one and only one of the following:\n\n- `NODE_EXTRA_CA_CERTS=/path/to/rootCA.pem` — adds the CA to the trusted store. More secure, but requires you to copy the certificate file from the GoodMem server to your machine.\n- `NODE_TLS_REJECT_UNAUTHORIZED=0` — disables certificate verification entirely. Easy and hassle-free, but not recommended for production.\n\n### How to configure\n\n**1. In English from chat** (GoodMem credentials only; TLS variables cannot be set this way)\n\nJust tell Claude your server details — it will call `goodmem_configure` automatically:\n\n```\n> \"Configure GoodMem with base URL https://my-server.com and API key gm_abc123\"\n```\n\nCredentials persist for the session. You can reconfigure anytime to switch servers. \n\n\n**2. Shell export** (before launching Claude Code; works for all configurations)\n\n```bash\nexport GOODMEM_BASE_URL=\"https://your-server.example.com\"\nexport GOODMEM_API_KEY=\"gm_...\"\nexport NODE_EXTRA_CA_CERTS=\"/path/to/rootCA.pem\"  # only if needed for self-signed certs\nexport NODE_TLS_REJECT_UNAUTHORIZED=0              # only if you want to skip cert verification\n```\n\n## Reloading after updates\n\nAfter installing a new version or pulling the latest changes, run `/reload-plugins` inside Claude Code to pick up the updates without restarting. If you are using the plugin from this repo, you can run `git pull` to get the latest changes.\n\n## What's included\n\n| Component | Description |\n|-----------|-------------|\n| `skills/help/` | Setup guide, available skills overview, example workflows |\n| `skills/python/` | Python SDK reference — method signatures, parameters, examples |\n| `skills/java/` | Java SDK usage reference — setup, builders, streaming, pagination, examples |\n| `skills/mcp/` | MCP tools reference — all 41+ tools with parameters |\n| `.mcp.json` | MCP server with auto-inference from 79 model registries |\n\n### Skills\n\n- **`goodmem:help`** — Overview of all skills, setup instructions, example workflows\n- **`goodmem:python`** — Python SDK reference for writing GoodMem code\n- **`goodmem:java`** — Java SDK reference for writing GoodMem code\n- **`goodmem:mcp`** — MCP tools reference for direct operations\n\n### MCP tools\n\nThe MCP server exposes all GoodMem API operations as tools:\n\n- **goodmem_configure** — set server credentials from chat\n- **goodmem_lookup_model** — look up model info from the registry (79 models: 29 embedders, 34 LLMs, 16 rerankers)\n- **embedders** — create, list, get, update, delete embedding models\n- **llms** — create, list, get, update, delete LLM configurations\n- **rerankers** — create, list, get, update, delete reranker models\n- **spaces** — create, list, get, update, delete memory spaces\n- **memories** — create, list, get, update, delete, retrieve, batch operations\n- **ocr** — extract text from documents\n- **users, apikeys, system, admin** — manage users, API keys, server\n\n### Auto-inference\n\nWhen creating embedders, LLMs, or rerankers, just provide `model_identifier` and the plugin auto-fills provider, endpoint, dimensions, and other fields from the built-in model registry. You only need to provide `display_name`, `model_identifier`, and credentials — everything else is inferred.\n\nExplicit values always override inferred defaults.\n\n### Credential validation\n\nSaaS providers (OpenAI, Cohere, Voyage, Jina, and OpenAI-compatible endpoints for Anthropic, Google, Mistral) require API credentials. If you create an embedder, LLM, or reranker pointing at a known SaaS hostname without providing credentials, the plugin raises a clear error before the request reaches the server. Pass `credentials` (MCP), `api_key` (Python SDK), or the provider API key overload (Java SDK) to proceed.\n\n## Links\n\n- [GoodMem Documentation](https://docs.goodmem.ai)\n- [Python SDK on PyPI](https://pypi.org/project/goodmem/)\n- [MCP Server on npm](https://www.npmjs.com/package/@pairsystems/goodmem-mcp)\n\n",
  "bytes": 5763,
  "sha": "9d0deab7cd39e336ca70eefaae4b70ba55901caa186ae9e9f51d2980dd66e1d5",
  "repo_slug": "pair-systems-inc/goodmem-claude-code-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_pair_systems_inc_goodmem_claude_code_plu_28457bdf/readme"
}