"Memory is like fiction; or else it's fiction that's like memory."

— Haruki Murakami

Cognitive Memory

A Quarkus-based cognition layer that processes conversation events from memory-service to extract and organize structured memories (topics, facts, preferences, etc.).

Architecture

• Memory Service (substrate layer) - Stores raw conversation data, manages access control
• Cognition Processor (this project) - Processes events to extract derived memories with LLMs

See Memory Cognition Architecture for core concepts and Enhancement 099 for implementation specification.

Quick Start

Option 1: AI-Assisted Setup (Recommended)

Start your AI assistant (Claude Code, Cursor, etc.) in this repository and type:

Please read the AGENTS.md and quickstart the application

The AI will guide you through the interactive setup process.

Option 2: Manual Setup

1. Memory Service

Set up and run memory-service locally:

→ memory-service/README.md

2. Cognition Processor

Run the Quarkus cognition processor:

→ cognition-processor-quarkus/README.md

How to Contribute

This project is primarily developed with AI assistance. To get started:

1. Get a task summary - Ask your AI agent:

   Please read the AGENTS.md and provide a summary of available TODO tasks
   

2. Your agent will check:

   • cognition-processor-quarkus/TODO/ - Informal task lists
   • GitHub Issues - Current bugs and feature requests

3. Work with your AI assistant to implement features, fix bugs, or improve documentation

We welcome contributions of all kinds - code, documentation, testing, and design improvements!

Learn More

• Memory Cognition Architecture - Core concepts and architecture
• cognition-processor-quarkus/AGENTS.md - Project context and guidelines
• cognition-processor-quarkus/TODO/ - Future work items
• cognition-processor-quarkus/DONE/ - Completed features
• Memory Service Docs

License

Apache License 2.0