Skip to main content

​
System Requirements

Supported platforms:
  • macOS (Apple Silicon or Intel)
  • Linux (x64 or ARM64)
Prerequisites:
  • Claude Code CLI or OpenCode must be installed
  • Bun runtime (only required if building from source)
Run the interactive installer: 
curl -fsSL https://github.com/clouitreee/LongMem/releases/latest/download/install.sh | bash
You’ll be guided through a simple setup wizard:
1

Choose Privacy Mode

Select from:
  • Safe (recommended) - Redacts secrets and blocks sensitive files
  • Flexible - Safe mode + custom regex patterns
  • None - No redaction (local-only setups)
2

Enable Auto-Context

Allow your AI assistant to automatically query memory (recommended: Yes)
3

Configure Compression (Optional)

Enable compression for better semantic search:
  • OpenRouter - meta-llama/llama-3.1-8b-instruct (cost-effective)
  • OpenAI - gpt-4o-mini
  • Anthropic - claude-haiku-4-5-20251001
  • Local - Ollama or LM Studio (no API key needed)

​
Non-Interactive Install

For automation or CI/CD, use headless mode: 
curl -fsSL https://github.com/clouitreee/LongMem/releases/latest/download/install.sh | bash -s -- --yes
This installs LongMem with default settings:
  • Privacy mode: safe
  • Auto-context: enabled
  • Compression: disabled
Edit ~/.longmem/settings.json after installation to customize settings.

​
Verify Installation

Check that the daemon is running: 
longmem status
Expected output (daemon running): 
✓ Daemon is running (PID: 12345)
✓ Health check: OK
✓ Port 38741: accessible
Expected output (daemon stopped): 
✗ Daemon is not running

To start:
  longmem start

​
What Gets Installed

The installer creates the following structure: 
~/.longmem/
├── bin/
│   ├── longmem         # Main CLI binary
│   ├── longmemd        # Daemon (symlink)
│   ├── longmem-mcp     # MCP server (symlink)
│   └── longmem-hook    # Hook handler (symlink)
├── hooks/
│   ├── post-tool.js    # Captures AI tool outputs
│   ├── prompt.js       # Captures user prompts
│   └── stop.js         # Session cleanup
├── logs/
│   └── daemon.log      # Daemon logs
├── memory.db           # SQLite database
├── settings.json       # Configuration
└── version             # Installed version
The installer also configures your AI assistant (Claude Code or OpenCode) to use LongMem hooks automatically.

​
Install Options

The installer supports additional flags: 
bash install.sh [OPTIONS]
OptionDescription
--yes, -ySkip all prompts (headless mode)
--dry-runPreview changes without modifying files
--no-serviceDon’t install systemd/launchd service
--opencodeConfigure OpenCode in addition to Claude Code
--allConfigure both Claude Code and OpenCode
Example: Install without systemd service: 
curl -fsSL https://github.com/clouitreee/LongMem/releases/latest/download/install.sh | bash -s -- --no-service

​
Troubleshooting

Use non-interactive mode to bypass prompts:
curl -fsSL https://github.com/clouitreee/LongMem/releases/latest/download/install.sh | bash -s -- --yes
Check logs for errors:
longmem logs -n 50
Common issues:
  • Port 38741 already in use (check ~/.longmem/settings.json to change port)
  • Corrupted settings file (LongMem auto-repairs invalid JSON)
LongMem automatically backs up corrupted config files:
ls ~/.longmem/settings.json*
# settings.json
# settings.json.bak  (auto-backup)
Restore the backup or delete settings.json and re-run the installer.
Ensure Claude Code or OpenCode is installed:
# Check for Claude Code
which claude-code

# Check for OpenCode
which opencode
If neither is found, install one before running the LongMem installer.

​
Updating LongMem

To update to the latest version, re-run the installer: 
curl -fsSL https://github.com/clouitreee/LongMem/releases/latest/download/install.sh | bash
Your existing settings.json and memory.db are preserved during updates.

​
Next Steps

Quickstart Guide

Get LongMem running and test memory functionality

Build docs developers (and LLMs) love

Get started for freeTalk to us