@audaxic/memory-claude

Claude Code plugin for Audaxic Memory — automatically saves conversation facts and injects semantic context into the agent.

Installation

npx @audaxic/memory-claude install

This will:

1. Prompt for your Audaxic API key (saved to ~/.config/audaxic/config.json)
2. Copy the plugin to ~/.claude/skills/audaxic-memory/
3. Configure the Audaxic MCP server (.mcp.json with your API key)

The plugin auto-loads on your next Claude Code session.

Get your API key from: https://memory-dashboard.audaxic.com

How It Works

The plugin combines three mechanisms:

Skill → auto-search on questions

An Agent Skill (skills/audaxic-memory/SKILL.md) instructs Claude to search Audaxic Memory before answering questions about your past decisions, projects, and preferences — then answer directly from the results.

MCP server → trusted memory tools

The plugin bundles the Audaxic MCP server (.mcp.json), giving Claude search_memories / add_memory / get_memories tools. MCP tool results are trusted by Claude, so memory recall actually reaches the answer.

Hooks → background saving

• UserPromptSubmit → inject.mjs: buffers your prompt and injects context via additionalContext (a passive enhancement — injection may be deprioritized by Claude Code, which is why the skill + MCP path exists)
• Stop → capture.mjs: buffers the assistant's response; flushes to POST /add at 30 messages

API Key

The plugin uses your API key in this order:

1. CLAUDE_PLUGIN_OPTION_API_TOKEN — set via the plugin's userConfig prompt during /plugin install
2. ~/.config/audaxic/config.json — shared config used by all Audaxic integrations

The key is also written into the plugin's .mcp.json at install time (mode 0600) so the MCP server authenticates automatically.

All scripts fail silently if no key is found — they never block Claude Code.

Architecture

┌──────────────────────────────────────────────────────────────┐
│                      Claude Code                             │
│                                                              │
│  User types prompt                                           │
│       │                                                      │
│       ▼                                                      │
│  UserPromptSubmit ──► inject.js                              │
│       │                  ├─ buffer user prompt to disk        │
│       │                  └─ POST /search → additionalContext  │
│       ▼                                                      │
│  Claude responds                                             │
│       │                                                      │
│       ▼                                                      │
│  Stop ──────────────► capture.js                             │
│                          ├─ buffer assistant msg to disk      │
│                          └─ if buffer >= 30 → POST /add      │
└──────────────────────────────────────────────────────────────┘

Uninstall

rm -rf ~/.claude/skills/audaxic-memory

API Endpoints

| Endpoint | Method | Description | |----------|--------|-------------| | https://api.memory.audaxic.com/search | POST | Search memories for context injection | | https://api.memory.audaxic.com/add | POST | Save conversation messages in batch |

Related

• Audaxic Memory
• Audaxic Memory for OpenCode
• Audaxic Memory for Codex
• Claude Code Hooks Documentation
• Claude Code Plugins Documentation

License

MIT