@devtheops/opencode-plugin-mempalace 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DEVtheOPS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,86 @@
+# opencode-plugin-mempalace
+
+[![npm version](https://img.shields.io/npm/v/@devtheops/opencode-plugin-mempalace.svg)](https://www.npmjs.com/package/@devtheops/opencode-plugin-mempalace)
+[![npm downloads](https://img.shields.io/npm/dm/@devtheops/opencode-plugin-mempalace.svg)](https://www.npmjs.com/package/@devtheops/opencode-plugin-mempalace)
+[![GitHub stars](https://img.shields.io/github/stars/DEVtheOPS/opencode-mempalace.svg)](https://github.com/DEVtheOPS/opencode-mempalace/stargazers)
+[![Build status](https://img.shields.io/github/actions/workflow/status/DEVtheOPS/opencode-mempalace/release-please.yml?branch=main)](https://github.com/DEVtheOPS/opencode-mempalace/actions/workflows/release-please.yml)
+[![License](https://img.shields.io/npm/l/@devtheops/opencode-plugin-mempalace.svg)](https://github.com/DEVtheOPS/opencode-mempalace/blob/main/LICENSE)
+
+An [OpenCode](https://opencode.ai) server plugin that integrates [MemPalace](https://github.com/MemPalace/mempalace) without vendoring the MemPalace application code.
+
+- [Installation](#installation)
+- [Requirements](#requirements)
+- [What It Adds](#what-it-adds)
+- [Runtime Behavior](#runtime-behavior)
+- [Development](#development)
+
+The plugin:
+
+- installs the `mempalace` Python package if it is missing
+- registers a local `mempalace` MCP server
+- injects MemPalace slash commands into OpenCode
+- injects a bundled `mempalace` skill into OpenCode
+
+## Installation
+
+Add the plugin to your OpenCode config:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@devtheops/opencode-plugin-mempalace"]
+}
+```
+
+For local development you can point OpenCode directly at this checkout:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["/path/to/opencode-mempalace/src/index.ts"]
+}
+```
+
+## Requirements
+
+- OpenCode
+- Python 3.9+
+- `pip`
+
+## What It Adds
+
+The plugin injects these commands:
+
+- `/mempalace-help`
+- `/mempalace-init`
+- `/mempalace-mine`
+- `/mempalace-search`
+- `/mempalace-status`
+
+It also injects:
+
+- a `mempalace` skill
+- a local `mempalace` MCP server that runs `python3 -m mempalace.mcp_server` or falls back to `python -m mempalace.mcp_server`
+
+If a `mempalace` MCP server is already configured, the plugin leaves it alone.
+
+## Runtime Behavior
+
+When OpenCode loads the plugin, it checks for `python3` or `python` and then verifies whether the `mempalace` package is importable.
+If not, it runs:
+
+```bash
+python3 -m pip install --upgrade mempalace
+```
+
+If installation fails, the plugin logs a warning and OpenCode continues running.
+
+## Development
+
+```bash
+bun install
+bun run typecheck
+bun test
+```
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for development and release workflow details.

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@devtheops/opencode-plugin-mempalace",
+  "version": "0.1.0",
+  "description": "MemPalace plugin for OpenCode. Installs the Python package, registers the MCP server, and injects commands and a bundled skill.",
+  "type": "module",
+  "author": "DEVtheOPS",
+  "license": "MIT",
+  "homepage": "https://github.com/DEVtheOPS/opencode-mempalace#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DEVtheOPS/opencode-mempalace.git"
+  },
+  "bugs": {
+    "url": "https://github.com/DEVtheOPS/opencode-mempalace/issues"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "mempalace",
+    "memory",
+    "mcp",
+    "python"
+  ],
+  "main": "./src/index.ts",
+  "module": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./server": "./src/index.ts"
+  },
+  "files": [
+    "src/",
+    "skills/"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.2.23",
+    "@opencode-ai/sdk": "^1.2.23",
+    "typescript": "^5.9.3"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "^25.6.0"
+  },
+  "scripts": {
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/skills/mempalace/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: mempalace
+description: MemPalace memory workflows for setup, mining, search, and palace status. Use when asked about MemPalace, memory palace setup, mining memories, or semantic memory search.
+license: MIT
+compatibility: opencode
+---
+
+# MemPalace
+
+MemPalace is a searchable memory system for mined projects and conversations.
+
+## Prerequisites
+
+This plugin tries to install `mempalace` automatically through `pip` when OpenCode loads the plugin.
+
+Verify the CLI is available:
+
+```bash
+mempalace --version
+```
+
+If it is still missing, install it manually:
+
+```bash
+python3 -m pip install --upgrade mempalace
+```
+
+or:
+
+```bash
+python -m pip install --upgrade mempalace
+```
+
+## Dynamic Instructions
+
+MemPalace ships operation-specific instructions. Fetch the guide for the workflow you need first:
+
+```bash
+mempalace instructions <command>
+```
+
+Supported commands:
+
+- `help`
+- `init`
+- `mine`
+- `search`
+- `status`
+
+After retrieving the instructions, follow them step by step.
+
+## MCP Server
+
+This plugin injects a local `mempalace` MCP server into OpenCode config at runtime.
+If the tools are missing, confirm the Python package installed successfully.

package/src/config.ts

@@ -0,0 +1,75 @@
+import type { Config } from "@opencode-ai/plugin";
+
+export type ConfigWithExtensions = Config & {
+  mcp?: Record<string, unknown>;
+  command?: Record<string, unknown>;
+  skills?: {
+    paths?: string[];
+    urls?: string[];
+  };
+};
+
+function ensureStringArray(value: unknown): string[] {
+  return Array.isArray(value) ? value.filter((item): item is string => typeof item === "string") : [];
+}
+
+function injectCommands(cfg: ConfigWithExtensions) {
+  cfg.command ??= {};
+
+  const commands = cfg.command as Record<string, unknown>;
+  const template = (workflow: string, description: string, extra = "") => ({
+    description,
+    template: [
+      "Use the `skill` tool to load the `mempalace` skill.",
+      `Then run \`mempalace instructions ${workflow}\` with the bash tool.`,
+      "Follow the returned instructions exactly and complete the workflow end to end.",
+      extra,
+    ]
+      .filter(Boolean)
+      .join("\n\n"),
+  });
+
+  commands["mempalace-help"] = template("help", "Show MemPalace usage, tools, and workflow guidance.");
+  commands["mempalace-init"] = template("init", "Install and initialize MemPalace for the current project.");
+  commands["mempalace-mine"] = template(
+    "mine",
+    "Mine a project or conversation export into MemPalace.",
+    "If command arguments are present, treat them as the target path or export to mine. Otherwise, use the current project root.",
+  );
+  commands["mempalace-search"] = template(
+    "search",
+    "Search memories stored in MemPalace.",
+    "If command arguments are present, treat them as the search query.",
+  );
+  commands["mempalace-status"] = template("status", "Show MemPalace status, room counts, and health.");
+}
+
+function injectMcp(cfg: ConfigWithExtensions) {
+  cfg.mcp ??= {};
+  const mcp = cfg.mcp as Record<string, unknown>;
+  if (mcp["mempalace"]) return;
+
+  mcp["mempalace"] = {
+    type: "local",
+    command: [
+      "sh",
+      "-lc",
+      "if command -v python3 >/dev/null 2>&1; then exec python3 -m mempalace.mcp_server; else exec python -m mempalace.mcp_server; fi",
+    ],
+    enabled: true,
+    timeout: 10000,
+  };
+}
+
+function injectSkill(cfg: ConfigWithExtensions, skillsDir: string) {
+  cfg.skills ??= {};
+  const paths = ensureStringArray(cfg.skills.paths);
+  if (!paths.includes(skillsDir)) paths.push(skillsDir);
+  cfg.skills.paths = paths;
+}
+
+export function applyMemPalaceConfig(cfg: ConfigWithExtensions, skillsDir: string) {
+  injectMcp(cfg);
+  injectCommands(cfg);
+  injectSkill(cfg, skillsDir);
+}

package/src/index.ts

@@ -0,0 +1,100 @@
+import { fileURLToPath } from "node:url";
+import type { Plugin } from "@opencode-ai/plugin";
+import type { ConfigWithExtensions } from "./config.ts";
+import { applyMemPalaceConfig } from "./config.ts";
+
+const PACKAGE_NAME = "mempalace";
+const SKILLS_DIR = fileURLToPath(new URL("../skills", import.meta.url));
+const IMPORT_CHECK = "import importlib.util, sys; sys.exit(0 if importlib.util.find_spec('mempalace') else 1)";
+
+type Logger = {
+  app?: {
+    log?: (input: {
+      body: {
+        service: string;
+        level: "debug" | "info" | "warn" | "error";
+        message: string;
+        extra?: Record<string, string>;
+      };
+    }) => Promise<unknown>;
+  };
+};
+
+async function log(
+  client: Logger,
+  level: "debug" | "info" | "warn" | "error",
+  message: string,
+  extra?: Record<string, string>,
+) {
+  if (!client.app?.log) return;
+  await client.app.log({
+    body: {
+      service: "opencode-plugin-mempalace",
+      level,
+      message,
+      extra,
+    },
+  });
+}
+
+async function run(cmd: string[]) {
+  const proc = Bun.spawn({
+    cmd,
+    stdout: "pipe",
+    stderr: "pipe",
+  });
+
+  const [stdout, stderr, exitCode] = await Promise.all([
+    new Response(proc.stdout).text(),
+    new Response(proc.stderr).text(),
+    proc.exited,
+  ]);
+
+  return { stdout, stderr, exitCode };
+}
+
+async function ensureMemPalaceInstalled(client: Logger) {
+  const python = Bun.which("python3") ?? Bun.which("python");
+  if (!python) {
+    await log(
+      client,
+      "warn",
+      "Could not find python3 or python. MemPalace MCP setup will remain unavailable until Python is installed.",
+    );
+    return;
+  }
+
+  const check = await run([python, "-c", IMPORT_CHECK]);
+  if (check.exitCode === 0) {
+    await log(client, "debug", "MemPalace Python package already installed.", { python });
+    return;
+  }
+
+  await log(client, "info", "Installing MemPalace Python package.", { python, package: PACKAGE_NAME });
+  const install = await run([python, "-m", "pip", "install", "--upgrade", PACKAGE_NAME]);
+
+  if (install.exitCode === 0) {
+    await log(client, "info", "Installed MemPalace Python package.", { python, package: PACKAGE_NAME });
+    return;
+  }
+
+  await log(client, "warn", "MemPalace Python package install failed.", {
+    python,
+    stderr: install.stderr.trim() || "unknown error",
+  });
+}
+
+export const server: Plugin = async ({ client }) => {
+  await ensureMemPalaceInstalled(client);
+
+  return {
+    config: async (cfg) => {
+      applyMemPalaceConfig(cfg as ConfigWithExtensions, SKILLS_DIR);
+    },
+  };
+};
+
+export default {
+  id: "devtheops.mempalace",
+  server,
+};