Bring your cross-tool memory into Amp with a native plugin, Context Bundle, MCP-style tools, and automatic thread capture.

For your agent

Give this line to Amp. It should use the universal install skill first; this page remains the behavior and troubleshooting reference:

Read https://mem.nowledge.co/SKILL.md and follow the instructions to install or update Nowledge Mem for Amp. Verify with nmem status and the Context Bundle or Working Memory check, then summarize what changed.

Amp is a coding agent with a native plugin API. Nowledge Mem uses that API directly: Amp gets your Context Bundle, memory search and save tools, graph expansion, command-palette actions, and automatic capture of the active Amp thread after an agent turn ends.

This is the dedicated Amp path. Use it before the Universal Agent Plugin, because Amp exposes host-specific lifecycle events and a thread API that the portable Agent Plugins standard does not provide.

Before You Start

Nowledge Mem running locally (installation) or a reachable remote Mem server
Amp installed
nmem CLI in your PATH. In Nowledge Mem go to Settings → Preferences → Developer Tools → Install CLI, or install nmem-cli

nmem status   # Nowledge Mem is reachable
amp --version # Amp is available

Setup

Install the plugin

From the community repository root:

bash nowledge-mem-amp-plugin/scripts/install.sh

The installer writes three Amp-owned entries:

Path	Purpose
`${XDG_CONFIG_HOME:-$HOME/.config}/amp/plugins/nowledge-mem.ts`	Discoverable root plugin entry
`${XDG_CONFIG_HOME:-$HOME/.config}/amp/plugins/nowledge-mem/`	Plugin bundle
`${XDG_CONFIG_HOME:-$HOME/.config}/amp/skills/nowledge-mem/`	Amp skill guidance

If XDG_CONFIG_HOME is set, the installer uses that config root instead of ~/.config.

Restart Amp

Close and reopen Amp so the plugin and skill are loaded.

Verify the integration

Run:

amp plugins list

You should see the Nowledge Mem plugin, its events, commands, and nowledge_mem_* tools.

Then start a new Amp session and ask:

What was I working on recently?

Amp should call nowledge_mem_context_bundle when full startup context matters, or nowledge_mem_working_memory as a lighter fallback, then return your current context.

To verify thread capture, finish a short Amp turn and search for a phrase from it:

nmem t search "the phrase you just used" --source amp

You should see an amp-... thread. If you do not, rerun the installer, restart Amp, and check that auto-sync has not been disabled with NMEM_AMP_AUTO_SYNC=0.

Update

Pull the latest community repo, then rerun:

bash nowledge-mem-amp-plugin/scripts/install.sh

Restart Amp after the update.

What You Can Do

Start with full context

Amp can load Context Bundle at the beginning of a session: owner identity, AI Identity, active space, Rules, Working Memory, and KFS paths.

Search before repeating work

When your current task depends on an old decision, a recurring procedure, or prior debugging context, Amp can search Mem directly.

Save durable knowledge

Amp can save decisions, preferences, procedures, and learnings into Nowledge Mem so other tools can find them later.

Explore relationships

nowledge_mem_graph_expand shows neighbouring memories and labelled edges around a memory when the agent needs to understand how one decision relates to others.

Keep Amp sessions searchable

After each agent turn, the plugin reads the current Amp thread through Amp's thread API and writes or appends the matching thread in Mem.

Tools

Tool	What it does
`nowledge_mem_context_bundle`	Read startup context: owner identity, AI Identity, active space, Rules, Working Memory, and KFS paths.
`nowledge_mem_working_memory`	Read today's lightweight Working Memory briefing.
`nowledge_mem_search`	Search knowledge from all your tools. Supports label, limit, and deep mode filters.
`nowledge_mem_save`	Save a decision, insight, procedure, or preference.
`nowledge_mem_update`	Update an existing memory with refined information.
`nowledge_mem_thread_search`	Search past conversations from any tool.
`nowledge_mem_save_thread`	Save the current Amp session as a full conversation thread on demand.
`nowledge_mem_save_handoff`	Save a curated handoff summary.
`nowledge_mem_graph_expand`	Expand graph neighbours and labelled edges around a memory.
`nowledge_mem_status`	Check Nowledge Mem connectivity and configuration.

How Session Capture Works

Nowledge Mem captures Amp sessions in three complementary ways:

Automatic live capture. On Amp's agent.end event, the plugin reads the current thread through Amp's thread API and saves it as source=amp. Captures are serialized per thread, so a manual save and an automatic save cannot race into duplicate writes.

Manual full session capture. nowledge_mem_save_thread uses the same capture path on demand. It is idempotent and remains useful when you want to save immediately.

Curated handoff. nowledge_mem_save_handoff saves a structured summary for resuming elsewhere. It complements full transcript capture; it is not the only record.

Remote Mem works because the plugin runs on the machine where Amp owns the transcript, then uploads to your configured Mem server. A remote Mem server cannot scan your local Amp sessions by itself.

Configuration

No config is needed for local use.

Env Variable	Default	What it does
`NMEM_API_URL`	(local)	Remote Nowledge Mem server URL
`NMEM_API_KEY`	(none)	API key for remote access
`NMEM_SPACE` / `NMEM_SPACE_ID`	(none)	Ambient space for this Amp session
`NMEM_AGENT_ID`	(none)	Stable Nowledge AI Identity for this run
`NMEM_HOST_AGENT_ID`	(none)	Advanced external-alias mapping
`NMEM_AMP_AUTO_SYNC`	`1`	Set to `0`, `false`, `off`, or `no` to disable automatic session capture
`NMEM_AMP_AUTO_SYNC_DEBOUNCE_MS`	`1500`	Debounce window for automatic capture

For persistent remote access, configure the machine running Amp once:

nmem config client set url https://your-server
nmem config client set api-key your-key

The Amp plugin reads the same shared Nowledge Mem client config as nmem.

Customize Safely

Use Amp's own instruction surfaces, not the installed plugin bundle:

Project rules: AGENTS.md
Personal global rules: ~/.config/amp/AGENTS.md

Do not edit files under ~/.config/amp/plugins/nowledge-mem/ directly. Re-run the installer when you want to update the connector.

Troubleshooting

Plugin not loading. Rerun bash nowledge-mem-amp-plugin/scripts/install.sh, confirm ~/.config/amp/plugins/nowledge-mem.ts exists, then restart Amp.

Tools are missing. Run amp plugins list. If the plugin is absent, Amp has not loaded the entrypoint. If the plugin is present but tools are absent, update Amp and reinstall the plugin.

nmem not found. Install the CLI from the desktop app's Developer Tools screen or install nmem-cli, then run nmem status.

Threads are not appearing. Finish a new Amp turn, wait for the agent.end capture to run, then search with nmem t search ... --source amp. If still empty, check NMEM_AMP_AUTO_SYNC and run nowledge_mem_save_thread once as a manual diagnostic.

Amp × Nowledge Mem