Memory Cloud

When to invoke

Use this skill only when the user explicitly wants to do one of the following:

• Save a memory (for example: "Remember this for me...", "Save this to memory...", "Use the memory skill to store this...").
• Read previously saved memories (for example: "Read my saved memories", "Fetch my memory", "Use memory-cloud to check my memories").

How to execute

Prerequisite before running any script:

• skill/config/config.env must exist and be configured.

Save a new memory

1. Summarize the memory content to be saved as markdown text based on the user's request, and extract a short title for it.
2. Run the save script with the required title.

Update a memory

• If the user clearly specifies which memory to update (by providing an id or a uniquely identifiable title), run the update command directly.
• If the user only says "update / overwrite / modify" but does not specify which memory, first run the list command, return the id + title list to the user, let the user choose the target, and then run the update command.

Read a memory

Rules:

• If the user clearly specifies which memory to read (by id or title), run the single-memory read command directly and return that memory's content (memory.content).
• If the user only says "read memory / read my previous memories" without specifying which one, first run the list command, return the id + title list to the user, let the user choose the target, and then run the single-memory read command.

Core commands

Read memory list

macOS / Linux:

bash scripts/read-memory.sh

Windows (PowerShell):

powershell -ExecutionPolicy Bypass -File scripts/read-memory.ps1

Save a new memory

macOS / Linux:

bash scripts/save-memory.sh --title "<标题>" --content "<记忆内容>"

Windows (PowerShell):

powershell -ExecutionPolicy Bypass -File scripts/save-memory.ps1 -Title "<title>" -Content "<memory content>"

Update a memory

macOS / Linux:

bash scripts/save-memory.sh --id "<memoryId>" --content "<new memory content>"
or
bash scripts/save-memory.sh --id "<memoryId>" --title "<title>" --content "<new memory content>"

Windows (PowerShell):

powershell -ExecutionPolicy Bypass -File scripts/save-memory.ps1 -Id "<memoryId>" -Content "<new memory content>"
or
powershell -ExecutionPolicy Bypass -File scripts/save-memory.ps1 -Id "<memoryId>" -Title "<title>" -Content "<new memory content>"

Read a single memory

macOS / Linux:

bash scripts/read-memory.sh --id "<memoryId>"
or
bash scripts/read-memory.sh --title "<title>"

Windows (PowerShell):

powershell -ExecutionPolicy Bypass -File scripts/read-memory.ps1 -Id "<memoryId>"
or
powershell -ExecutionPolicy Bypass -File scripts/read-memory.ps1 -Title "<title>"

Expected response

• Save/update memory succeeds: { "ok": true, "id": "...", "createdAt": "...", "updatedAt": "..." }
• Read memory list succeeds: { "ok": true, "memories": [ { "id": "...", "title": "...", "created_at": "...", "updated_at": "..." } ] }
• Read a single memory succeeds: { "ok": true, "memory": { "id": "...", "title": "...", "content": "...", "metadata": {...}, "created_at": "...", "updated_at": "..." } } or { "ok": true, "memory": null }
• Failure: the script exits with a non-zero status and outputs an HTTP error message. If the output is 401 Unauthorized, it means the API Key is invalid or expired, and the user should generate a new API Key.

Security constraints

• Avoid storing any secrets, tokens, passwords, or personal sensitive information.
• Do not directly read or modify any content inside config/config.env.