wa-memory

library0.1.3jsnpmunverified

A local-first CLI tool that syncs WhatsApp messages via wacli into SQLite, indexes them with OpenAI embeddings (text-embedding-3-small), and provides semantic RAG-style question answering. Version 0.1.3, early stage. Key differentiators: data stays on your machine, no cloud storage; uses wacli for WhatsApp pairing and export; combines vector search with virtual filesystem grep for enriched retrieval; supports chat, ask, search, send, react, and file operations via terminal or web server. Requires Node.js 22+, OpenAI API key, and wacli (Homebrew).

messaging ai-ml

npm install wa-memory

package ↗

INSTALL

IMPORT

SIG · WA-MEMORY

wa-memory

messagingjavascriptv0.1.3

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

wa-memory CLI

✓ npm install -g wa-memory

✗ npm install wa-memory

This is a CLI tool, not a library. Install globally or use npx. Do not import as a module.

Installs the CLI globally, runs the interactive first-run wizard to pair WhatsApp and set up OpenAI, then syncs messages and demonstrates the ask and chat commands.

npm install -g wa-memory wa-memory # Follow interactive setup wizard: # 1. Scan QR code with WhatsApp linked devices # 2. Enter OpenAI API key when prompted # After setup: wa-memory sync wa-memory ask "What did we discuss about the project?" wa-memory chat

Debug

Known issues

breakingVersion 0.1.x uses wacli externally via child process and expects it installed at brew location. Not included in npm package.

fix

Install wacli separately: brew install steipete/tap/wacli

affects: >=0.1.0

gotchaRequires Node.js >=22. Older versions will throw ERR_UNSUPPORTED_ENGINE or similar.

fix

Update Node.js to version 22 or newer

affects: >=0.1.0

deprecatedThe wizard defaults to QR flow but also supports phone-code pairing. In future versions the QR-only path may be removed.

fix

Use 'wa-memory setup --phone +1234567890' for phone-code pairing

affects: >=0.1.0

Errors

Common errors & fixes

wa-memory: command not found

Package not installed globally or not in PATH.

fix

Run: npm install -g wa-memory

Error: Cannot find module 'better-sqlite3'

Missing native dependency due to platform mismatch or incomplete install.

fix

Run: npm install -g wa-memory (or npx wa-memory) to trigger rebuild

wacli: command not found

wacli binary not installed or not in PATH.

fix

Run: brew install steipete/tap/wacli

Upgrade

Version history

0.1.3latest on npm

Audit

Dependencies

better-sqlite3requiredRuns SQLite database for storing WhatsApp messages and embeddings locally

openairequiredOpenAI Node.js SDK for creating embeddings and chat completions

waclirequiredExternal binary managed by homebrew, required for WhatsApp authentication and message export

commanderrequiredCLI command parsing and subcommands (sync, chat, ask, etc.)

@langchain/corerequiredLangChain core for text splitting and vector store abstractions

ipullrequiredUsed for interactive CLI prompts during setup wizard

picocolorsrequiredTerminal colored output for CLI messages

Agent activity

38 hits · last 30 days

node

OpenAI (training)

Resources

packagewa-memory ↗