# Goodmem:help

> Overview of all available GoodMem skills and what a user needs to get started. Invoke when a user asks what GoodMem skills are available, how to get started, or what they need to set up.

- **Type:** Skill
- **Install:** `agentstack add skill-pair-systems-inc-goodmem-claude-code-plugin-help`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [PAIR-Systems-Inc](https://agentstack.voostack.com/s/pair-systems-inc)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [PAIR-Systems-Inc](https://github.com/PAIR-Systems-Inc)
- **Source:** https://github.com/PAIR-Systems-Inc/goodmem-claude-code-plugin/tree/main/skills/help

## Install

```sh
agentstack add skill-pair-systems-inc-goodmem-claude-code-plugin-help
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# GoodMem Plugin — Help & Overview

GoodMem is memory infrastructure for AI agents — store, retrieve, and manage memories with vector embeddings, semantic search, and RAG.

## Credential Setup

Before calling any GoodMem MCP tool, you MUST ensure credentials are configured. Follow this sequence:

1. Try calling `goodmem_system_info` to check if credentials are already set (from environment variables).
2. If it fails with a connection or auth error, ask the user for:
   - **Base URL** — their GoodMem server address (e.g., `https://your-server.example.com`)
   - **API key** — starts with `gm_`
3. Call `goodmem_configure` with the provided `base_url` and `api_key`.
4. Confirm the connection succeeded before proceeding.

Credentials persist for the entire session. The user can call `goodmem_configure` again to switch servers.

If the user has set `GOODMEM_BASE_URL` and `GOODMEM_API_KEY` environment variables before starting Claude Code, credentials are picked up automatically — no setup needed.

**TLS errors?** If `goodmem_system_info` fails with a certificate verification error (e.g., "self-signed certificate", "unable to verify the first certificate", or "CERT_HAS_EXPIRED"), the GoodMem server is using a self-signed or private CA certificate. Tell the user to set one of these environment variables before launching Claude Code:
- `NODE_EXTRA_CA_CERTS=/path/to/rootCA.pem` — adds the CA to the trusted store (recommended)
- `NODE_TLS_REJECT_UNAUTHORIZED=0` — disables certificate verification (local dev only)

## Available Skills

### `goodmem:mcp` — MCP Tools Reference
Reference for all GoodMem MCP tools. Use this when you need to look up tool names, parameters, or behavior. The MCP tools let you operate GoodMem directly — create embedders, store memories, run retrieval — all via natural language.

### `goodmem:python` — Python SDK Reference
Complete API reference for the `goodmem` Python package. Use this when writing Python code that integrates with GoodMem. Includes method signatures, convenience shortcuts, model identifiers, and code examples.

### `goodmem:java` — Java SDK Reference
Usage reference for the `ai.pairsys:goodmem-java` package. Use this when writing Java code that integrates with GoodMem. Includes client setup, request builders, typed IDs, streaming, pagination, async usage, and common RAG patterns.

### `goodmem:help` — This skill
Overview and setup instructions.

## Three Ways to Use GoodMem

### 1. Direct operations (MCP tools)
Ask Claude to perform GoodMem operations in natural language. Claude calls MCP tools behind the scenes.

Examples:
- "Create an OpenAI embedder called 'my-embedder' using text-embedding-3-large"
- "Create a space called 'knowledge-base' using that embedder"
- "Store this text as a memory in the knowledge-base space"
- "Search my knowledge-base for information about authentication"
- "List all my spaces"

### 2. Python code generation (SDK skill)
Ask Claude to write Python code using the GoodMem SDK.

Examples:
- "Write a Python script that creates an embedder and stores some documents"
- "Show me how to do semantic retrieval with the GoodMem SDK"
- "Write a RAG pipeline using GoodMem for memory storage"

### 3. Java code generation (SDK skill)
Ask Claude to write Java code using the GoodMem SDK.

Examples:
- "Write a Java program that creates an embedder and stores documents"
- "Show me Java streaming retrieval with the GoodMem SDK"
- "Write a Java RAG pipeline using GoodMem with typed request builders"

## Common Workflows

### Quick start with MCP
1. "Create an embedder using text-embedding-3-large with my OpenAI key"
2. "Create a space called 'docs' using that embedder"
3. "Store this text as a memory: [your content]"
4. "Search docs for [your query]"

### Build a RAG app with an SDK
1. "Write a Python or Java script that sets up a GoodMem RAG pipeline"
2. Claude generates code using the `goodmem` Python package or `ai.pairsys:goodmem-java`
3. Run the generated script

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [PAIR-Systems-Inc](https://github.com/PAIR-Systems-Inc)
- **Source:** [PAIR-Systems-Inc/goodmem-claude-code-plugin](https://github.com/PAIR-Systems-Inc/goodmem-claude-code-plugin)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-pair-systems-inc-goodmem-claude-code-plugin-help
- Seller: https://agentstack.voostack.com/s/pair-systems-inc
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.