CogmemAi — Cognitive Memory for Claude Code

Claude Code forgets everything between sessions. CogmemAi fixes that.

One command. One env var. Claude Code remembers your architecture, patterns, decisions, bugs, and preferences — permanently.

npx -y cogmemai-mcp

The Problem

Every time you start a new Claude Code session, you lose context. You re-explain your tech stack, your architecture decisions, your coding preferences. Claude Code's built-in memory is a 200-line flat file with no search, no structure, and no intelligence.

CogmemAi gives Claude Code a real memory system:

• Semantic search — finds relevant memories by meaning, not keywords
• Ai-powered extraction — automatically identifies facts worth remembering from your conversations
• Project scoping — memories tied to specific repos, plus global preferences that follow you everywhere
• Time-aware surfacing — recent and important memories rank higher
• Zero setup — no databases, no Docker, no Python, no vector stores

Why Not Local Memory?

Every local memory solution has the same problems: database corruption, memory leaks, version conflicts, complex setup. claude-mem (13K+ stars) leaks 15GB+ of RAM. mcp-memory-service released v10.0.0 marked "BROKEN."

CogmemAi runs extraction and search server-side. Your MCP server is a thin HTTP client — zero local databases, zero RAM issues, zero crashes.

Quick Start

1. Get your API key

Sign up at hifriendbot.com/developer and generate an API key.

2. Add to Claude Code

Add to your project's .mcp.json (or ~/.claude.json for global):

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "cogmemai-mcp"],
      "env": {
        "COGMEMAI_API_KEY": "cm_your_api_key_here"
      }
    }
  }
}

3. Done

Claude Code now has persistent memory. It will remember your architecture, preferences, and decisions across every session.

Tools

CogmemAi provides 8 tools that Claude Code can use automatically:

Memory Types

Memories are categorized for better organization and retrieval:

• identity — Who you are, your role, team
• preference — Coding style, tool choices, conventions
• architecture — System design, tech stack, file structure
• decision — Why you chose X over Y
• bug — Known issues, fixes, workarounds
• dependency — Version constraints, package notes
• pattern — Reusable patterns, conventions
• context — General project context

Scoping

• Project memories — Architecture, decisions, bugs specific to one repo. Auto-detected from git remote.
• Global memories — Your coding preferences, identity, tool choices. Available in every project.

Pricing

Start free. Upgrade when you need more.

Privacy & Security

• No source code leaves your machine. We store extracted facts (short sentences), never raw code.
• API keys hashed with SHA-256 (irreversible) server-side.
• All traffic over HTTPS.
• No model training on your data. Ever.
• Delete everything instantly via dashboard or MCP tool.
• No cross-user data sharing.

Read our full privacy policy.

Environment Variables

How It Works

Your Terminal                          CogmemAi Cloud
┌──────────────┐                     ┌─────────────────────┐
│ Claude Code  │                     │ 3-Layer Memory      │
│              │                     │                     │
│ cogmemai-mcp │ ──── HTTPS ────►    │ 1. Ai Extraction    │
│ (MCP Server) │ ◄──── JSON ────    │ 2. Semantic Search  │
│              │                     │ 3. Time-Aware Rank  │
└──────────────┘                     └─────────────────────┘

1. Extraction — When Claude Code works on your project, CogmemAi's Ai identifies important facts (architecture decisions, preferences, bugs) and stores them.
2. Embedding — Each memory gets a semantic embedding vector for meaning-based search.
3. Surfacing — When you start a new session, relevant memories are surfaced by meaning, importance, and recency.

Works Everywhere

CogmemAi works in any terminal that runs Claude Code:

• PowerShell
• bash / zsh
• Windows Terminal
• macOS Terminal / iTerm2
• VS Code terminal
• Any SSH session

Support

• Issues: GitHub Issues
• Docs: hifriendbot.com/developer

License

MIT — see LICENSE

Built by HiFriendbot — Better Friends, Better Memories, Better Ai.