ekkOS™ Documentation

Build AI agents with persistent memory, pattern learning, and hallucination detection

Quick Start

1. Install ekkOS MCP Server

Install the ekkOS MCP server via npm. Authentication is handled automatically via Claude subscription mode.

View Full Docs

2. Install MCP Server

Add ekkOS to your Claude Desktop or IDE configuration:

{
  "mcpServers": {
    "ekkos-memory": {
      "command": "npx",
      "args": ["-y", "@ekkos/mcp-server"],
      "env": {
        "EKKOS_API_KEY": "your-key-here"
      }
    }
  }
}

3. Start Using Core Memory Tools

ekkOS_Search- Search your memory for past solutions
ekkOS_Forge- Save important decisions and patterns
ekkOS_Conflict- Validate AI suggestions against your history

Quick Start

Core Concepts

Core Memory Tools

Integration

11-Layer Memory System

ekkOS implements an advanced 11-layer memory architecture inspired by cognitive science:

1

Working Memory

Recent chat messages (24h window)

2

Episodic Memory

Conversation episodes and context

3

Semantic Memory

Compressed knowledge entries

4

Pattern Memory

Reusable strategies and solutions

5

Procedural Memory

Step-by-step workflows

6

Collective Memory

Cross-agent learning (7d window)

7

Meta Memory

System self-awareness records

8

Codebase Memory

Code embeddings for semantic search

9

Directives

User rules (MUST/NEVER/PREFER/AVOID)

10

Conflicts

Directive conflict resolution

11

Secrets Vault

Encrypted credentials (AES-256-GCM)

The Golden Loop

The self-improving cycle that makes ekkOS smarter with every interaction:

1

Retrieve

2

Apply

3

Measure

4

Learn

Need Help?

Join our community or reach out to support for assistance

Contact SupportGitHub