# 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

```bash
npm install
npm run build
```

## Usage

### API Server

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

```bash
# 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:

```json
{
  "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

| Feature | Free | Pro ($9/mo) | Enterprise |
|---------|------|-------------|------------|
| Memories | 1,000 | Unlimited | Unlimited |
| Requests/day | 100 | 10,000 | Unlimited |
| Self-hosted | - | - | ✓ |

## 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.