Oceanir Memory

Persistent memory for AI coding agents. Remember context across sessions.

Features

• Entity Storage - Store people, projects, patterns, preferences, solutions
• Relations - Link entities together (uses, prefers, solved, etc.)
• Observations - Add notes to entities over time
• Search - Full-text search across all memories
• Graph - Explore connected knowledge

Installation

npm install
npm run build

Usage

API Server

npm run api
# Runs on http://localhost:3000

# Store a memory
curl -X POST http://localhost:3000/remember \
  -H "Content-Type: application/json" \
  -d '{"name": "prefers-typescript", "type": "preference", "content": "User prefers TypeScript over JavaScript"}'

# Search memories
curl "http://localhost:3000/recall?q=typescript"

# Get stats
curl http://localhost:3000/stats

MCP Server (Claude/Cursor)

Add to your MCP config:

{
  "mcpServers": {
    "oceanir-memory": {
      "command": "node",
      "args": ["/path/to/oceanir-memory/dist/mcp.js"]
    }
  }
}

MCP Tools:

• remember - Store a memory
• recall - Search memories
• observe - Add observation to entity
• relate - Create relation between entities
• get_preferences - Get all preferences
• get_patterns - Get patterns and solutions
• memory_stats - Get stats
• forget - Delete entity

API Tiers

Entity Types

• person - User or team member info
• project - Project details and config
• file - Important file notes
• concept - Technical concepts
• preference - User preferences (coding style, tools)
• pattern - Code patterns to follow
• error - Common errors encountered
• solution - Solutions to problems

License

Proprietary - See LICENSE file.