Get Started
Three Ways to Run MemoCat
Requires Node.js 24+ (for built-in node:sqlite). Run the macOS desktop app, the local web server, or the Chrome/Edge extension independently or together.
Option 01 · macOS Desktop App
Electron Desktop Workbench
Includes native macOS menu bar, view shortcuts (⌘1..5), background tray service on port 3792, and DMG / MAS bundle scripts.
git clone https://github.com/qiwihui/MemoCat.git
cd memocat
npm install
npm run desktop
Run npm run build:dmg to produce a local macOS disk image.
Option 02 · Local Web Mode
Node.js Built-in HTTP Server
The backend relies solely on Node.js built-in modules. Open http://127.0.0.1:3792 for full archive, recall, and MCP endpoints.
npm start
# Custom data directory & port
MEMO_DATA_DIR=/path/to/data PORT=3792 npm start
On macOS, you can also double-click Start MemoCat.command after cloning.
Option 03 · Chrome / Edge Extension
Load MV3 Extension
Build the extension package and load the unpacked output under Developer Mode in chrome://extensions.
npm run build:extension
# Load unpacked folder:
# dist/memocat-extension
Click "Connect & Sync" inside the extension to automatically pair with port 3792.