lhm.plugin.json

{
  "identifier": "yonro-memory-os-cli",
  "name": "XMemo CLI",
  "description": "Shared, governed long-term memory for AI agents across tools and sessions via MCP and REST.",
  "author": "yonro",
  "authorUrl": "https://github.com/yonro",
  "homepage": "https://xmemo.dev/product/mcp",
  "icon": "https://raw.githubusercontent.com/yonro/memory-os-cli/main/plugins/xmemo/assets/logo.png",
  "version": "0.4.345",
  "category": "productivity",
  "connectionType": "hybrid",
  "cloudEndpoint": "https://xmemo.dev/mcp",
  "tags": [
    "xmemo",
    "mcp",
    "memory",
    "ai-agents",
    "knowledge-management",
    "streamable-http",
    "oauth",
    "privacy"
  ],
  "deploymentOptions": [
    {
      "installationMethod": "npm",
      "isRecommended": true,
      "description": "Install @xmemo/client and run its dedicated token-free discovery server over stdio.",
      "installationDetails": {
        "packageName": "@xmemo/client"
      },
      "connection": {
        "type": "stdio",
        "command": "xmemo-mcp",
        "args": []
      },
      "systemDependencies": [
        {
          "name": "nodejs",
          "type": "runtime",
          "requiredVersion": ">=20.0.0",
          "checkCommand": "node --version",
          "versionParsingRequired": true,
          "installInstructions": {
            "macos": "brew install node@20",
            "linux_debian": "sudo apt install nodejs npm",
            "windows": "Download Node.js 20 or newer from https://nodejs.org/en/download/",
            "manual": "Install Node.js 20 or newer from https://nodejs.org/en/download/"
          }
        }
      ]
    },
    {
      "installationMethod": "manual",
      "isRecommended": false,
      "description": "Connect directly to the hosted Streamable HTTP endpoint with MCP OAuth or an XMemo bearer token.",
      "connection": {
        "type": "http",
        "url": "https://xmemo.dev/mcp"
      }
    }
  ],
  "tools": [
    {
      "name": "get_mcp_identity",
      "description": "Check XMemo connection status and the connected account or agent."
    },
    {
      "name": "remember",
      "description": "Save a memory so it can be recalled in future conversations."
    },
    {
      "name": "recall",
      "description": "Recall the most relevant saved memories before answering."
    },
    {
      "name": "recall_context",
      "description": "Read a multi-memory context pack with explicit item/token budgets; use recall for a lightweight answer or get_project_context for a project snapshot."
    },
    {
      "name": "memory_stats",
      "description": "Show aggregate statistics for XMemo memories."
    },
    {
      "name": "update_memory",
      "description": "Update the content or metadata of an existing memory."
    },
    {
      "name": "explain_memory",
      "description": "Explain why a memory exists or matched a query."
    },
    {
      "name": "restore_memory",
      "description": "Restore a previously deleted memory."
    },
    {
      "name": "add_expense",
      "description": "Create one XMemo Ledger transaction and backing memory for an expense, income, refund, or transfer."
    },
    {
      "name": "list_ledger_transactions",
      "description": "Show XMemo Ledger records."
    },
    {
      "name": "get_monthly_ledger_summary",
      "description": "Summarize Ledger totals by month and currency."
    },
    {
      "name": "forget",
      "description": "Permanently delete a memory by target."
    },
    {
      "name": "create_memory_todo",
      "description": "Create a TODO or action item with an optional due time."
    },
    {
      "name": "list_memory_todos",
      "description": "List open or completed TODO and action items."
    },
    {
      "name": "complete_memory_todo",
      "description": "Mark a TODO or action item completed."
    },
    {
      "name": "list_memory_versions",
      "description": "List available versions for a memory."
    },
    {
      "name": "get_timeline",
      "description": "Read authorized timeline events newest first; use recall_context for semantic multi-memory context."
    },
    {
      "name": "record_event",
      "description": "Record a significant session event, milestone, or decision."
    },
    {
      "name": "update_state",
      "description": "Create or replace scoped working state for resuming a task; use remember for durable facts."
    },
    {
      "name": "get_project_context",
      "description": "Read one authorized project's bounded context pack when an exact project_id is known."
    }
  ],
  "prompts": [
    {
      "name": "remember",
      "description": "Save a memory to XMemo for future recall across sessions.",
      "arguments": [
        {
          "name": "content",
          "description": "The text to remember.",
          "required": true,
          "type": "string"
        },
        {
          "name": "path",
          "description": "Optional category path for the memory.",
          "required": false,
          "type": "string"
        }
      ]
    },
    {
      "name": "recall",
      "description": "Recall relevant memories from XMemo before answering a question.",
      "arguments": [
        {
          "name": "query",
          "description": "What to search for in memory.",
          "required": true,
          "type": "string"
        }
      ]
    },
    {
      "name": "project-context",
      "description": "Build a context pack from XMemo for the current project or task.",
      "arguments": [
        {
          "name": "query",
          "description": "Describe the project or task context needed.",
          "required": true,
          "type": "string"
        }
      ]
    }
  ],
  "resources": [
    {
      "uri": "xmemo://docs/getting-started",
      "name": "XMemo MCP quick start",
      "mimeType": "text/markdown"
    },
    {
      "uri": "xmemo://docs/security",
      "name": "XMemo security and privacy",
      "mimeType": "text/markdown"
    }
  ]
}