Skip to main content

Agent Memory Skill

Enable persistent memory for AI coding agents via Audaxic's MCP server. Agents automatically search and save memories based on behavioral triggers.


Choose Your Agent​

AgentFileLocation
Universal ReferenceAUDAXIC_MEMORY.mdProject root
Claude CodeSKILL.md.claude/skills/audaxic-memory/
Cursoraudaxic-memory.mdc.cursor/rules/
Windsurf / Devinaudaxic-memory.md.devin/rules/
Clineaudaxic-memory.md.clinerules/
GitHub Copilotaudaxic-memory.instructions.md.github/instructions/
OpenCodeSKILL.md.opencode/skills/audaxic-memory/
OpenAI Codexconfig.toml~/.codex/config.toml

Quick Start​

1. Add Skill File​

Click your agent above, copy the file content, and place it in the specified location.

2. Test Connection​

npx @modelcontextprotocol/inspector --transport http --server-url https://memory-mcp.audaxic.com/mcp --header "Authorization: Bearer ak_your_key_here"

Behavioral Triggers​

Before acting, search for prior context:

  • Making architectural decisions → search for prior decisions
  • Adding new dependencies → search for existing preferences
  • Fixing bugs → search for known issues
  • Starting new sessions → search for user preferences

When to AUTO-SAVE​

After learning something new:

  • User states a preference → save preference
  • Decision with rationale → save decision + reasoning
  • Complex bug fixed → save solution pattern
  • Conventions learned → save conventions

When NOT to Save​

  • Temporary state (use variables/cache)
  • Debug info
  • Secrets, API keys, passwords

MCP Tools Reference​

ToolParametersDescription
add_memorytext (required), user_id?, metadata?Store new memory
search_memoriesquery (required), user_id?, limit?Semantic search
get_memoriesuser_id?, limit?List all memories
delete_memorymemory_ids[] (required)Delete by IDs
delete_all_memoriesuser_id?Delete all

Content Best Practices​

  • One fact per memory — avoid bundling unrelated information
  • Natural language — use sentences, not keywords
  • Include reasoning — store decisions, not just outcomes
  • Be specific — better specificity = better semantic matching

Memory Lifecycle​

Add → Search → Update (delete + re-add) → Delete (when obsolete)

Troubleshooting​

MCP connection fails​

Test your connection:

npx @modelcontextprotocol/inspector --transport http --server-url https://memory-mcp.audaxic.com/mcp --header "Authorization: Bearer ak_your_key_here"

Skill not showing up​

  1. Verify file is in correct location
  2. Check frontmatter includes name and description (for SKILL.md format)
  3. Restart your agent after adding the file

Memories not persisting​

  1. Verify MCP server is connected
  2. Check API key is valid at memory-dashboard.audaxic.com
  3. Ensure user_id and project_id are consistent across sessions

See Also​