<div align="center">

# Celiums

### Your AI doesn't know what it doesn't know. And it forgets everything.

**The open-source engine that gives AI persistent memory and instant access to 5,100+ expert knowledge modules — with a biological clock that adapts to each user.**

[![npm version](https://img.shields.io/npm/v/@celiums/memory?style=flat-square&color=22c55e)](https://www.npmjs.com/package/@celiums/memory)
[![Downloads](https://img.shields.io/npm/dw/@celiums/memory?style=flat-square&color=22c55e)](https://www.npmjs.com/package/@celiums/memory)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square)](https://github.com/terrizoaguimor/celiums-memory/blob/main/LICENSE)

</div>

---

## Quick Start

```bash
npm install -g @celiums/cli
celiums init
```

That's it. `celiums init` will:
- Ask your name, timezone, and chronotype (morning/night)
- Load 5,100 expert knowledge modules
- Auto-configure Claude Code, Cursor, and VS Code
- Create your personal cognitive profile

## 6 MCP Tools

| Tool | What it does |
|---|---|
| `forage` | Search 5,100+ expert modules |
| `absorb` | Load a specific module |
| `sense` | Get recommendations for a goal |
| `map_network` | Browse all categories |
| `remember` | Store persistent emotional memory |
| `recall` | Retrieve by semantic relevance |

## This Package

This package is part of the **Celiums** monorepo. You don't need to install it directly — `@celiums/cli` handles everything.

For full documentation, architecture, REST API reference, Docker deployment, and more:

**[github.com/terrizoaguimor/celiums-memory](https://github.com/terrizoaguimor/celiums-memory)**

## License

- **Code:** [Apache 2.0](https://github.com/terrizoaguimor/celiums-memory/blob/main/LICENSE)
- **Starter Modules:** [CC-BY-NC-4.0](https://github.com/terrizoaguimor/celiums-memory/blob/main/packages/modules-starter/LICENSE)