Bub × Nowledge Mem
Bring your cross-tool knowledge into Bub, and share what you learn in Bub with every other tool.
pip install nowledge-mem-bubBub records every session through its tape system. Nowledge Mem adds the layer above: knowledge from all your other AI tools — decisions made in Claude Code, preferences set in Cursor, insights from ChatGPT — searchable inside Bub. And what you learn in Bub flows back to every other tool.
Before You Start
- Nowledge Mem running locally (installation)
- Bub installed (bub.build)
nmemCLI in your PATH — in Nowledge Mem go to Settings > Developer Tools > Install CLI, orpip install nmem-cli
nmem status # Nowledge Mem is running
uv run bub --help # Bub is availableSetup
Install the plugin
pip install nowledge-mem-bubVerify
uv run bub hooksYou should see nowledge_mem listed for system_prompt, load_state, and save_state.
Try it
Ask Bub something that depends on your past work:
uv run bub run "what was I working on this week?"If you have existing knowledge in Nowledge Mem, the agent should find it through mem.search. That's success — Bub can now see knowledge from your other tools.
What You Can Do
Find knowledge from other tools
Ask "what did we decide about the database?" and the agent searches across decisions you made in Claude Code, insights from ChatGPT, notes from Cursor — not just this Bub session.
Save knowledge for everywhere
When you reach a conclusion in Bub, mem.save stores it so your next Claude Code session, Cursor project, or ChatGPT conversation can find it too.
Start with today's context
With session context mode on, your Working Memory briefing and relevant past knowledge are ready before you ask. No repeating yourself across tools.
Trace how ideas evolved
mem.connections shows how a decision changed over time, which tools you discussed it in, and what source documents back it up.
Two Modes
| Mode | Config | What happens |
|---|---|---|
| Default | nothing | The agent searches and saves on demand. Conversations flow into Mem for other tools to find. |
| Session context | NMEM_SESSION_CONTEXT=1 | Working Memory and relevant knowledge injected automatically each turn. |
Most users should start with the default. Enable session context when you want guaranteed recall from the first message.
Tools
| Tool | What it does |
|---|---|
mem.search | Search knowledge from all your tools. Supports label and date filters. |
mem.save | Save a decision, insight, or preference so any tool can find it. |
mem.context | Read today's Working Memory — focus areas, priorities, recent activity. |
mem.connections | Explore how a piece of knowledge relates to others across tools and time. |
mem.timeline | Recent activity grouped by day. |
mem.forget | Delete a memory by ID. |
mem.threads | Search past conversations from any tool. |
mem.thread | Fetch full messages from a conversation with pagination. |
mem.status | Connection and configuration diagnostics. |
All tools work as Bub comma commands too: ,mem.search query=...
Configuration
No config needed for local use.
| Env Variable | Default | What it does |
|---|---|---|
NMEM_SESSION_CONTEXT | false | Inject Working Memory + recalled knowledge each turn |
NMEM_SESSION_DIGEST | true | Feed Bub conversations into Mem for other tools to find |
NMEM_API_URL | (local) | Remote Nowledge Mem server URL |
NMEM_API_KEY | (none) | API key for remote access |
The plugin also reads ~/.nowledge-mem/config.json (shared with all Nowledge Mem integrations). Environment variables take priority.
Remote access
{
"apiUrl": "https://your-server",
"apiKey": "your-key"
}See Access Mem Anywhere.
Troubleshooting
Plugin not loading — Run uv run bub hooks and check for nowledge_mem. Make sure nowledge-mem-bub is installed in the same Python environment as Bub.
nmem not found — pip install nmem-cli && nmem status
Server not responding — Start the Nowledge Mem desktop app, or check nmem status for diagnostics.
Related
- Integrations overview
- Claude Code · OpenClaw · Alma · Gemini CLI
- Plugin source: nowledge-mem-bub-plugin
- tape.systems · bub.build