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