setup

MemoryLayer Setup Skill

Automated setup and verification for MemoryLayer.

Activation

This skill activates when users ask about:

• Setting up MemoryLayer
• Configuring memory settings
• Troubleshooting memory issues

Instructions

When this skill is activated, perform the following steps automatically. Do not just describe the steps — execute them.

Step 1: Check Server Connection

Run a health check against the MemoryLayer server:

curl -sf http://localhost:61001/health

If the server is unreachable, offer to install and start it:

pip install memorylayer-server
memorylayer serve &

Wait a few seconds after starting, then re-check health.

Step 2: Auto-Configure Permissions

Check if MemoryLayer tool permissions are already configured. Read .claude/settings.local.json (create the file if it doesn't exist). If the permissions allow list does not include the memorylayer wildcard, add it:

{
  "permissions": {
    "allow": [
      "mcp__plugin_memorylayer_memorylayer__*"
    ]
  }
}

Important: If .claude/settings.local.json already exists, read it first and merge the permission into the existing allow array. Do not overwrite other settings.

Step 3: Verify MCP Tools

Call memory_briefing to confirm the MCP tools are connected and working. This simultaneously:

• Verifies the MCP server is running
• Verifies the SDK can communicate with the MemoryLayer server
• Returns workspace stats

If this fails, check that the plugin is installed (/plugin list) and that the server is running (Step 1).

Step 4: Run Smoke Test

Perform a store-recall-forget cycle to verify end-to-end functionality:

1. Store: memory_remember with content "MemoryLayer setup verification test" and tags ["setup-test"]
2. Recall: memory_recall with query "setup verification test" — verify the test memory is returned
3. Forget: memory_forget with the memory ID from step 1 — clean up the test memory

If any step fails, report the error and suggest checking server logs.