# directory [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/Patheras/the-anots  
**GitHub Stars:** 0  
**npm Downloads (last month):** 2933  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/directory

## Description
Discover and query every business on ANOTS — search, ask, or find-and-ask over MCP.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "directory": {
    "url": "http://localhost:6333/health"
  }
}
```

## Documentation & README

# TCAM Memory System

Resilient 4-Layer Memory Architecture for TCAM v1.4 (Triadic Cognitive Augmentation Model)

## Overview

The TCAM Memory System implements a fault-tolerant memory architecture where each layer operates independently, ensuring that system failures in one layer do not cascade to others. Memory operations are handled by a dedicated Memory Service running on Qwen 3.5 9B (local LLM).

## Architecture

### Four Independent Layers

- **L1: Chronicle** - Immutable historical record (file system, markdown)
- **L2: Active Stream** - Volatile working memory (Cloud LLM context + Redis)
- **L3: Hive Mind** - Semantic memory (Qdrant vector DB + Mem0)
- **L4: Agent Codex** - Personal knowledge base (file system, markdown)

### Memory Service

Dedicated process running on Qwen 3.5 9B for:
- Truth extraction from dialogue
- Chronicle inscription
- Hive Mind indexing
- Agent Codex updates
- Sleeping cycle orchestration

## Technology Stack

- **TypeScript/Node.js** - Core implementation
- **Qwen 3.5 9B** - Local LLM for memory operations
- **Mem0** - Automatic fact extraction
- **Qdrant** - Vector database for semantic search
- **Redis** - Fast state persistence (LangGraph checkpointer)
- **LangGraph** - Multi-agent orchestration
- **Jest** - Testing framework
- **fast-check** - Property-based testing

## Project Structure

```
.
├── src/                    # Source code
├── tests/                  # Test files
├── data/                   # Chronicle storage
├── codex/                  # Agent Codex (L4)
├── docs/                   # Documentation
└── .kiro/specs/           # Specification documents
```

## Getting Started

### Prerequisites

- Node.js 18+
- Ollama (for Qwen 3.5 9B)
- Docker (for Qdrant and Redis)

### Installation

```bash
# Install dependencies
npm install --legacy-peer-deps

# Pull Qwen 3.5 9B model
ollama pull qwen2.5:9b-instruct-q4_K_M

# Pull embedding model
ollama pull nomic-embed-text

# Start Qdrant (using setup script)
# Windows PowerShell:
.\scripts\setup-qdrant.ps1

# Linux/Mac:
bash scripts/setup-qdrant.sh

# Or manually with Docker:
docker run -d --name qdrant -p 6333:6333 -p 6334:6334 -v qdrant_storage:/qdrant/storage qdrant/qdrant

# Start Redis
docker run -d --name redis -p 6379:6379 redis

# Build and install globally
npm run build
npm install -g . --legacy-peer-deps
```

### CLI Usage

```bash
# Interactive main menu
anots

# Real-time monitoring dashboard (Terminal UI)
anots dashboard

# Chat with Axiom (TCAM Node C)
anots axiom

# Start MCP server (19 tools for IDE integration)
anots mcp:start

# Start REST API server
anots api:start

# Start API with Axiom chat endpoint
anots api:start --axiom

# Search memory
anots memory:search "your query"

# Import conversation (JSON/Markdown)
anots import conversation.json --type general

# System status
anots status

# Configuration wizard
anots setup

# Show all commands
anots --help
```

### Dashboard Features

The Terminal UI dashboard (`anots dashboard`) provides:
- Real-time memory layer health monitoring
- System statistics (chapters, sessions, memories)
- Activity log with timestamps
- Keyboard shortcuts (F1-F3, R, Q)
- Auto-refresh every 2 seconds
- Cyberpunk aesthetic with 90s BBS vibes

### Verify Setup

```bash
# Check Qdrant
curl http://localhost:6333/health

# Check Redis
redis-cli ping

# Check Ollama
ollama list
```

### Development

```bash
# Build
npm run build

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Lint
npm run lint

# Format code
npm run format
```

## Importing Conversations

Import large conversation files into the ANOTS memory system:

```bash
# Import Ubik conversation
npm run import -- data/import/conversation.json --type ubik

# Import Axiom conversation
npm run import -- data/import/conversation.md --type axiom

# Preview import without writing (dry run)
npm run import -- data/import/conversation.json --dry-run

# Custom chunk size (messages per chapter)
npm run import -- data/import/large-file.json --type ubik --chunk-size 100
```

### What Gets Imported

1. **Chronicle**: Conversation history in chapters
2. **Hive Mind**: Semantic indexing for search
3. **Codex**: Extracted truths and insights

See `data/import/README.md` for detailed documentation and examples.

## Specification

See `.kiro/specs/memory-system/` for complete specification:
- `requirements.md` - Functional requirements
- `design.md` - Technical design
- `tasks.md` - Implementation tasks

## License

MIT