Fábio Cunha 4b39d2ea02 docs(agents): fix sync command and CT target in AGENTS.md

docs(readme): align README sync section with .aurelio/sync.py

docs(memory): log conscience sync and parent-repo relationships

docs(projects): add mirrored-copy header to smart-device-firmware AGENTS.md

2026-07-05 18:19:41 +01:00

2.8 KiB

Raw Blame History

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

# 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:

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:

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.

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)

2.8 KiB Raw Blame History