mem9-setup

name	mem9-setup
description	Setup Mem9 persistent memory. Triggers: set up mem9, install mem9, configure memory, enable memory.
context	fork
allowed-tools	Bash, Read, Write, Edit

Mem9 Setup for Claude Code

You are an automated installer. Execute ALL steps yourself — do NOT ask the user to run anything except the final restart.

Step 1: Check if already configured

python3 -c "
import json, os, sys
path = os.path.expanduser('~/.claude/settings.json')
if not os.path.exists(path):
    print('NO_SETTINGS')
    sys.exit(0)
with open(path) as f:
    cfg = json.load(f)
tid = cfg.get('env', {}).get('MEM9_TENANT_ID', '')
if tid:
    print(f'ALREADY_CONFIGURED:{tid}')
else:
    print('NEEDS_TENANT')
"

• If ALREADY_CONFIGURED:<id> → Skip to Step 3.
• If NEEDS_TENANT or NO_SETTINGS → Continue to Step 2.

Step 2: Provision tenant and write config

2a: Provision a new tenant

curl -s -X POST https://api.mem9.ai/v1alpha1/mem9s

Extract the id field from the JSON response. This is the MEM9_TENANT_ID.

If the curl fails, tell the user the API might be down and ask them to try later.

2b: Write tenant ID to settings.json

Read ~/.claude/settings.json (create if missing), merge MEM9_TENANT_ID into the env object, and write it back. Preserve all existing settings.

python3 -c "
import json, os, sys

tenant_id = sys.argv[1]
path = os.path.expanduser('~/.claude/settings.json')

# Read existing or start fresh
cfg = {}
if os.path.exists(path):
    with open(path) as f:
        cfg = json.load(f)

# Merge env
env = cfg.get('env', {})
env['MEM9_TENANT_ID'] = tenant_id
cfg['env'] = env

# Write back
os.makedirs(os.path.dirname(path), exist_ok=True)
with open(path, 'w') as f:
    json.dump(cfg, f, indent=2)
    f.write('\n')

print(f'OK: MEM9_TENANT_ID={tenant_id} written to {path}')
" "REPLACE_WITH_ACTUAL_TENANT_ID"

Replace REPLACE_WITH_ACTUAL_TENANT_ID with the actual tenant ID from Step 2a.

Step 3: Install plugin

Try CoWork first (preferred), fall back to marketplace if CoWork is not installed.

Option A: CoWork

cowork install mem9-ai/mem9-claude-plugin --plugin

If cowork is not installed, fall back to Option B.

Option B: Marketplace CLI

claude plugin marketplace add mem9-ai/mem9

claude plugin install mem9@mem9

If claude plugin marketplace add fails with "already exists", that's fine — skip it and continue to install.

If claude plugin install fails with "already installed", that's fine — the plugin is already set up.

Step 4: Confirm and tell user to restart

Summarize what was done:

• ✅ Tenant provisioned: <tenant_id>
• ✅ ~/.claude/settings.json updated with MEM9_TENANT_ID
• ✅ Plugin marketplace added and plugin installed

Then tell the user:

All done! Just restart Claude Code to activate Mem9 memory.

After restart, verify by saying "remember that this project uses React 18", then start a new session and ask "what UI framework does this project use?" — the agent should recall it.