Advanced Installation

claude-mem install --dir ~/my-custom-path

export CLAUDE_MEM_HOME=~/my-custom-path

claude-mem install --save-on-clear

claude-mem install --force

claude-mem install --verbose

FROM node:18-alpine
RUN npm install -g claude-mem
RUN claude-mem install --dir /data/claude-mem
ENV CLAUDE_MEM_HOME=/data/claude-mem

# Set proxy
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080

# Install with proxy
npm install -g claude-mem --proxy http://proxy.company.com:8080
claude-mem install

npm config set registry https://registry.company.com/
npm install -g claude-mem
claude-mem install

# Install as root
sudo npm install -g claude-mem

# Each user runs
claude-mem install --user

~/.claude-mem/
├── index/                  # Chroma vector database
│   ├── chroma.sqlite3     # Main database
│   └── collections/       # Memory collections
├── archives/              # Compressed conversations
│   └── YYYY-MM-DD/       # Date-organized
├── hooks/                 # Claude Code integration
│   ├── pre-compact.js    # Before /compact command
│   ├── session-start.js  # On session start
│   └── session-end.js    # On session end
├── trash/                 # Smart Trash system
│   ├── memories/         # Deleted memories
│   └── metadata.json     # Recovery metadata
├── logs/                  # System logs
│   ├── install.log       # Installation log
│   ├── hooks.log         # Hook execution log
│   └── errors.log        # Error tracking
├── settings.json         # User configuration
└── mcp-config.json      # MCP server config

{
  "mcpServers": {
    "chromadb-claude-mem": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/server-chromadb",
        "--collections",
        "claude_memories"
      ],
      "env": {
        "CHROMA_PATH": "~/.claude-mem/index"
      }
    }
  }
}

{
  "mcpServers": {
    "chromadb-claude-mem": {
      "command": "node",
      "args": [
        "~/.claude-mem/node_modules/@modelcontextprotocol/server-chromadb/dist/index.js"
      ]
    }
  }
}

claude-mem install --hooks-dir ~/my-hooks

claude-mem install --skip-hooks session-end

module.exports = async (context) => {
  // Your custom logic
  console.log('Custom hook triggered!');
};

# Full backup
tar -czf claude-mem-backup.tar.gz ~/.claude-mem

# Selective backup
claude-mem export --output memories-backup.json

# Full restore
tar -xzf claude-mem-backup.tar.gz -C ~/

# Selective restore
claude-mem import --input memories-backup.json

# On old machine
claude-mem export --full --output claude-mem-export.zip

# On new machine
claude-mem import --full --input claude-mem-export.zip

# Custom home directory
export CLAUDE_MEM_HOME=~/custom/path

# Debug mode
export CLAUDE_MEM_DEBUG=true

# Disable telemetry (already off by default)
export CLAUDE_MEM_NO_TELEMETRY=true

# Custom log level
export CLAUDE_MEM_LOG_LEVEL=debug

# Memory search limit
export CLAUDE_MEM_MAX_RESULTS=20

# Remove hooks and configuration
claude-mem uninstall

# Remove package
npm uninstall -g claude-mem

# Remove all data (WARNING: deletes all memories)
rm -rf ~/.claude-mem

# Remove from Claude Code settings
# Manually remove MCP server config from Claude Code settings.json