memclaw

Memclaw — Workspace Manager

The agent's external brain for projects. Once activated, the agent continuously syncs artifacts and knowledge into the corresponding LiveDoc, so that anyone (including future sessions or teammates) can load that workspace and instantly recover full context.

Core Concepts

Concept	Description
Workspace	One project = one LiveDoc
Active Workspace	Current session state; all operations auto-sync to this workspace
README	The agent's memory of the project; actively maintained by the agent
Artifacts	Important outputs; the agent asks before saving
Registry	~/.memclaw/workspaces.json, mapping project names to LiveDoc IDs and project summaries

Registry format:

{
  "workspaces": {
    "Health Management": {
      "id": "nkYv32xA2dEHNpyT4xdZkq",
      "summary": "Triggers when user talks about diet, exercise, weight, calories, health tracking"
    }
  }
}

Registry maintenance rules:

• After creating a workspace → add a record with id and summary
• After loading a workspace → if it is not already in the registry, add it
• After deleting a workspace → remove the corresponding record
• After renaming → update the record name
• The summary field syncs from the README summary field. If the API returns a summary, use it; otherwise generate a one-line project description in the user's language.
• The registry key must be the project name (in the user's language). Never use a short_id as the key.
• If the API errors (502/401/timeout), do not write or modify the registry. Do not use placeholders or short_id as a fallback. Wait until the API is healthy again before writing.

Project existence verification (important):

• Never decide that a project exists based on memory alone. Before saying "this project already exists", you must verify it via the registry file or $SCRIPT list --keyword.
• short_id must come from a real query result in the current turn (registry, list, or create output), not from stale context in your head.
• If project verification fails (API error), do not pretend the project exists and do not invent project metadata. Tell the user there is a network issue and retry later, or create a new project directly.