# Réplica Omnisciente

The centralized hybrid memory engine and AI agent orchestration hub for the **Portugal Futurista** IoT ecosystem.

## Architecture

```
~/.aurelio/                    Global config (like ~/.gemini/antigravity)
<workspace>/.aurelio/          Per-workspace config & brain
replica-omnisciente/
├── .aurelio/                  Central store: brain, sessions, MCP servers, skills
├── realms/                    Per-project knowledge & AGENTS.md
├── extensions/                VS Code extensions
│   ├── aurelio-vscode/        Main Aurelio IDE integration
│   └── kimi-interceptor/      Kimi Code → local model proxy
├── AGENTS.md                  Agent bootstrapping protocol
└── .aurelio/sync.py           Fleet synchronization bridge (replaces legacy sync.sh)
```

## The `.aurelio` Paradigm

Three-tier cascading configuration, modeled on `.gemini/antigravity`:

| Tier | Location | Scope |
|------|----------|-------|
| **Global** | `~/.aurelio/` | User-wide settings, identity, global KIs |
| **Workspace** | `<project>/.aurelio/` | Project-specific brain, sessions, MCP config |
| **Realm** | `realms/<name>/.aurelio/` | Domain-specific memory & knowledge |

## Quick Start

```bash
# Clone
git clone git@github.com:fabiorafaelcoutada/replica-omnisciente.git

# Deploy .aurelio sync bridge to a workspace
cp -r .aurelio/sync.py <target-workspace>/.aurelio/

# Install VS Code extension
cd extensions/aurelio-vscode
npm install && npm run compile
```

## MCP Servers

Located in `.aurelio/mcp/`:

| Server | Purpose |
|--------|---------|
| `electrical-mcp` | EDA, sourcing, knowledge services |
| `jules-mcp-server` | Jules agent orchestration |

## Sync

The system auto-syncs brain artifacts to the Proxmox server at `mcp.portugalfuturista.org` via the Aurelio VS Code extension or manually:

```bash
python3 .aurelio/sync.py --push   # Broadcast changes to fleet
python3 .aurelio/sync.py --pull   # Ingest latest from fleet
```

### Kimi Chat Sync

To import Kimi Code CLI session history and plans into the central brain:

```bash
python3 scripts/sync-kimi-to-brain.py --skip-active
```

This reads `~/.kimi/sessions/` and `~/.kimi/plans/` and writes normalized Aurelio-brain
artifacts to `.aurelio/brain/session-kimi-<uuid>/` and `.aurelio/brain/kimi-plans/`.
Run it before `python3 .aurelio/sync.py --push` to broadcast Kimi conversations to the fleet.

## Related Repositories

| Repository | Purpose |
|------------|---------|
| `ode-triunfal-firmware` | ESP32/STM32 firmware |
| `nervura-electrica` | Infrastructure (Proxmox, Traefik, MQTT) |
| `aprendiz-de-sensacoes` | ML training & inference |
| `maquina-na-mao` | Flutter mobile app |
| `janela-do-desassossego-web` | Web dashboard |
| `guarda-livros-da-ode` | Backend API (Django) |