Alma

Read https://mem.nowledge.co/docs/integrations/alma.mdx, then help me install or update Nowledge Mem for Alma. Use the recommended path first, verify the setup with the success check in the guide, and summarize what changed.

Memory that follows every Alma conversation. Install once from the marketplace, no configuration required. Connect to a remote Mem instance with Access Anywhere for use across machines.

Source: community/nowledge-mem-alma-plugin

Before You Start

• Nowledge Mem running locally (installation) or a reachable remote Mem server
• Alma installed, with access to its plugin marketplace

Setup

Use the Nowledge Mem status tool and tell me whether the server is connected.

Update

Open Settings → Plugins → Marketplace in Alma, find Nowledge Mem, and click Update if a newer version is available.

Disable or Uninstall

• To pause automatic thread capture without uninstalling, set autoCapture to off in the Nowledge Mem plugin settings.
• To pause preloaded recall, set recallPolicy to off or use strict_tools when you only want explicit tool calls.
• To remove the integration, disable or uninstall Nowledge Mem from Alma's Settings → Plugins page. If you installed a local copy manually, quit Alma and remove ~/.config/alma/plugins/nowledge-mem.

Customize Safely

Alma does not expose a separate package-owned override file for this plugin.

• Use Alma's plugin settings for durable behavior changes such as remote mode, recall policy, thread capture, and space selection
• If you want the agent to speak or save differently, use Alma's own prompt or instruction surfaces instead of patching plugin code

Do not edit installed plugin files just to keep a small preference. For the full host-by-host map, see Customize Integration Behavior.

What the Plugin Does

Thread Saving

Threads are saved automatically during normal use — the plugin syncs your conversation after a few seconds of idle, when you switch threads, or when you quit Alma. No action needed. Saved threads appear in the Nowledge Mem desktop app and can be distilled into structured memories later.

During conversation, the AI may also save specific insights or decisions as individual memories using the nowledge_mem_store tool. This happens when the conversation produces something durable — architecture decisions, debugging conclusions, preferences. For casual chat, the AI intentionally avoids saving noise.

If you want something specific remembered, just ask: "save this to memory."

Full-library backup (optional)

For a portable archive of every Alma thread — new Mem library, compliance, or a clean machine — use Alma Settings → Data → Export all threads. That produces alma-backup-*.zip with threads.json inside.

In Nowledge Mem, open Threads → Import → Bulk Import and pick the ZIP. Imported threads use the same alma source label as live plugin sync, so filters stay consistent. Other bulk formats and CLI options: Import existing conversations and Bulk import formats.

Access Anywhere

To connect to a remote Nowledge Mem instance:

1. In Alma, open Settings → Plugins → Nowledge Mem
2. Set API URL to your remote server (e.g. https://mem.example.com)
3. Set API Key to your nmem_... key
4. Changes take effect immediately. Use nowledge_mem_status to verify

The API key is read from Alma's plugin settings, sent as an Authorization: Bearer ... header, and never logged.

Spaces

Alma can keep one ambient memory lane per profile.

• Use NMEM_SPACE="Research Agent" when you already launch Alma in one stable lane.
• Or set nowledgeMem.space in Alma settings when one Alma profile always belongs to one lane.
• nowledgeMem.spaceTemplate is only for advanced setups where your launcher already exports a trustworthy lane variable, such as ${ALMA_AGENT_NAME}.

If Alma does not know a real agent identity, stay on Default or use separate Alma profiles for separate lanes.

Related

• Integrations overview: native integrations, reusable packages, MCP, and browser capture
• Claude Code · Claude Desktop · Codex CLI · OpenClaw · Raycast · Others