Shared Memory

---

name: shared-memory

description: Share memories and state with other users. Use when user wants to share knowledge, create users/groups, grant permissions, set up family or team sharing, subscribe to memory changes, or manage access control on their memory knowledge base. This shared memory skill uses Ensue - a shared memory network for agents.

metadata:

clawdbot:

emoji: "🤝"

requires:

env:

- ENSUE_API_KEY

primaryEnv: ENSUE_API_KEY

homepage: https://ensue-network.ai

---

# Shared Memory

Share memories from your knowledge base with other users. Manage users, groups, and fine-grained permissions on namespaces.

Quick Start

# Create user and group
{baseDir}/scripts/shared-memory.sh create-user mark
{baseDir}/scripts/shared-memory.sh create-group family
{baseDir}/scripts/shared-memory.sh add-member family mark

# Grant access
{baseDir}/scripts/shared-memory.sh grant group family read christine/shared/
{baseDir}/scripts/shared-memory.sh grant group family update christine/shared/

Namespace Organization

<username>/
├── private/    # Only this user
├── shared/     # Shared with others
└── public/     # Read-only to others

Grant access to `mark/shared/` → all shared content

Grant access to `mark/shared/recipes/` → just recipes

Commands

Users

| Command | Description |

|---------|-------------|

| `create-user <username>` | Create user |

| `delete-user <username>` | Delete user |

Groups

| Command | Description |

|---------|-------------|

| `create-group <name>` | Create group |

| `delete-group <name>` | Delete group |

| `add-member <group> <user>` | Add user to group |

| `remove-member <group> <user>` | Remove user |

Permissions

| Command | Description |

|---------|-------------|

| `grant org <action> <pattern>` | Grant to org |

| `grant user <name> <action> <pattern>` | Grant to user |

| `grant group <name> <action> <pattern>` | Grant to group |

| `revoke <grant_id>` | Revoke permission |

| `list` | List all grants |

| `list-permissions` | List effective permissions |

**Actions**: `read`, `create`, `update`, `delete`

Subscriptions

| Command | Description |

|---------|-------------|

| `subscribe <key>` | Get notified on changes |

| `unsubscribe <key>` | Stop notifications |

| `list-subscriptions` | List subscriptions |

Example: Family Sharing

# Create user for partner
{baseDir}/scripts/shared-memory.sh create-user mark

# Create family group
{baseDir}/scripts/shared-memory.sh create-group family
{baseDir}/scripts/shared-memory.sh add-member family mark

# Grant mutual access to shared/ namespaces
{baseDir}/scripts/shared-memory.sh grant group family read christine/shared/
{baseDir}/scripts/shared-memory.sh grant group family create christine/shared/
{baseDir}/scripts/shared-memory.sh grant group family update christine/shared/
{baseDir}/scripts/shared-memory.sh grant group family read mark/shared/
{baseDir}/scripts/shared-memory.sh grant group family update mark/shared/

Troubleshooting

If commands fail, first check if an Ensue API key is configured:

echo $ENSUE_API_KEY
grep -A2 'ensue-learning-memory' ~/.clawdbot/clawdbot.json

If no API key found, tell user to get a free key at https://www.ensue-network.ai/login and configure in `~/.clawdbot/clawdbot.json`:

{
  "skills": {
    "entries": {
      "ensue-learning-memory": {
        "apiKey": "their-api-key-here"
      }
    }
  }
}

If key exists but commands fail, the key may be invalid - have user generate a new one.