4b39d2ea02
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
83 lines
2.8 KiB
Markdown
83 lines
2.8 KiB
Markdown
# 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) |
|