Windows Configuration Guide

This guide helps Windows users set up and use LimbicDB.

Prerequisites

1. Install Node.js 20+

1. Download from: https://nodejs.org
2. Choose Windows Installer (.msi)
3. During installation, ensure "Add to PATH" is checked
4. Verify installation:

   node --version
   npm --version

2. (If needed) Visual Studio Build Tools

If you encounter errors during npm install about native modules:

1. Download from: https://visualstudio.microsoft.com/downloads/
2. Install "Desktop development with C++" workload
3. This provides the C++ compiler needed for better-sqlite3

Installation

Global Installation (Recommended)

npm install -g limbicdb

Verify Installation

limbicdb --help
# or
limbicdb

Basic Usage

Remember a Memory

limbicdb remember "This is my first memory"

Recall Memories

limbicdb recall "first"

List Sessions

limbicdb sessions

Export Memories

limbicdb export > memories.jsonl

Import Memories

limbicdb import < memories.jsonl

Common Issues

Issue: limbicdb command not found

Solution: Add npm global binaries to PATH

# Find npm global directory
npm config get prefix

# Add to PATH (replace with your actual path)
$env:Path += ";C:\Users\YourName\AppData\Roaming\npm"

# Make it permanent
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Users\YourName\AppData\Roaming\npm", "User")

Issue: better-sqlite3 installation fails

Symptoms:

Error: Could not locate the bindings file

Solutions:

1. Install Build Tools (see Prerequisites above)

2. Or use prebuilt binaries:

   npm install --build-from-source=better-sqlite3

3. Or try WSL (Windows Subsystem for Linux):

   wsl
   # Then follow Linux installation instructions

Issue: PowerShell execution policy blocks scripts

Solution:

# Allow script execution for current user
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Issue: Path too long errors

Symptoms:

Error: ENOENT: no such file or directory

Solution: Enable long paths in Windows

1. Open Registry Editor (regedit)
2. Navigate to: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem
3. Set LongPathsEnabled to 1
4. Reboot

Using with OpenClaw

1. Install OpenClaw for Windows

Follow OpenClaw's Windows installation guide.

2. Configure LimbicDB Adapter

In your OpenClaw configuration:

{
  "plugins": {
    "limbicdb": {
      "enabled": true,
      "path": "C:\\Users\\YourName\\.limbicdb"
    }
  }
}

3. Test Integration

Start a new OpenClaw session and try:

Remember that I prefer TypeScript over JavaScript

Then start a new session and ask:

What programming language do I prefer?

PowerShell Tips

Create a Function for Quick Access

Add to your PowerShell profile ($PROFILE):

function limbic-remember {
    param([string]$text)
    limbicdb remember $text
}

function limbic-recall {
    param([string]$query)
    limbicdb recall $query
}

Then use:

limbic-remember "My important note"
limbic-recall "important"

File Locations

Item	Default Location
Database	./agent.limbic (current directory)
Global config	%APPDATA%\npm\node_modules\limbicdb
User data	C:\Users\YourName\.limbicdb

Next Steps

• Read the main README.md for full documentation
• Check examples/ for usage examples
• Join our community to share feedback

Need Help?

• Check TROUBLESHOOTING.md
• Open an issue on GitHub
• Ask in our community channels