<p align="center">
  <img src="docs/hero.png" alt="Unforgit — AI forgets everything. We fix that." width="100%" />
</p>

<h1 align="center">Unforgit</h1>

<p align="center">
  <strong>Long-term memory for AI agents and developer workflows.</strong><br>
  Capture locally, rank by reuse, share when it matters.
</p>

<p align="center">
  <a href="https://www.npmjs.com/package/unforgit"><img src="https://img.shields.io/npm/v/unforgit.svg" alt="npm version"></a>
  <a href="https://github.com/MiguelMedeiros/unforgit/releases/latest"><img src="https://img.shields.io/github/v/release/MiguelMedeiros/unforgit?label=release" alt="latest GitHub release"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT"></a>
  <a href="https://github.com/MiguelMedeiros/unforgit"><img src="https://img.shields.io/github/stars/MiguelMedeiros/unforgit.svg?style=social" alt="GitHub stars"></a>
</p>

<p align="center">
  <code>npm install -g unforgit</code>
</p>

---

## Quick Start

```bash
# Initialize in any repo
unforgit init

# Save a memory
unforgit add "We use UTC timestamps everywhere" --type semantic --tags "convention"

# Recall by meaning
unforgit recall "how to deploy" --types procedural,semantic --k 5

# Open the local memory dashboard
unforgit dashboard
```

## Documentation

| Topic | Description |
|-------|-------------|
| [Concepts](docs/concepts.md) | Memory types, scopes, statuses, visibility policy, lifecycle |
| [CLI Reference](docs/cli.md) | All CLI commands — add, recall, templates, curate, merge, sync |
| [Configuration](docs/configuration.md) | OpenAI, authentication, sync settings, YAML config |
| [API Server](docs/api.md) | HTTP API setup, endpoints, request examples |
| [Server-Side AI](docs/server-ai.md) | Team mode with server-side OpenAI integration |
| [MCP Server](docs/mcp.md) | Cursor IDE integration via Model Context Protocol |
| [Agent Tools](docs/agent-tools.md) | Programmatic TypeScript interface |
| [Architecture](docs/architecture.md) | Project structure, semantic search, development |

## Development

```bash
pnpm dev:server    # Start API server with hot reload
pnpm dev:cli       # Run CLI in dev mode
pnpm build         # Build for production
pnpm test          # Run tests
```

