██████╗  █████╗ ██████╗  ██████╗ ██╗     ██████╗ ██╗ ██████╗
    ██╔══██╗██╔══██╗██╔══██╗██╔═══██╗██║     ██╔══██╗██║██╔═══██╗
    ██████╔╝███████║██████╔╝██║   ██║██║     ██║  ██║██║██║   ██║
    ██╔══██╗██╔══██║██╔═══╝ ██║   ██║██║     ██║  ██║██║██║   ██║
    ██║  ██║██║  ██║██║     ╚██████╔╝███████╗██████╔╝██║╚██████╔╝
    ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝      ╚═════╝ ╚══════╝╚═════╝ ╚═╝ ╚═════╝

rapoldio CLI

Multi-agent CLI for ÆON & ÆTHRA — Cyberpunk dashboards, fleet management, Pi deployment

---

Overview

rapoldio CLI is a multi-agent, modular command-line framework for managing a fleet of Raspberry Pis. It powers cyberpunk-styled tmux dashboards featuring matrix rain animations, live cryptocurrency charts, world clocks, weather feeds, news tickers, and system monitoring.

🤖 The Agent Concept

This CLI supports two AI agent identities that share the same codebase but have distinct personalities:

Agent	Identity	Focus
ÆON	The Architect	Infrastructure, building, deployment, systems
ÆTHRA	The Companion	Creative, personal, monitoring, insight

Each agent gets its own entrypoint (aeon / aethra), dashboard branding, task panels, and status displays — while sharing the same core modules, fleet management, and market/weather/news panels.

Key Features

• 🤖 Multi-Agent — Two agent identities (ÆON & ÆTHRA) with shared infrastructure
• 🎨 Adaptive Resolution — Auto-detects SD/HD/FHD/QHD/UHD and adjusts tmux layout
• 🐉 Matrix Rain Top Bar — Animated katakana rain behind centered figlet header
• 📈 Live Market Charts — 7-day BTC/ETH/Gold charts with sparklines (CoinGecko API)
• 🌍 World Clock & Weather — Multi-timezone display with Zurich weather (Open-Meteo)
• 📰 News Ticker — Rotating crypto & local news feeds (RSS)
• 🔧 Plugin System — Drop a module.sh into modules/ and it auto-registers
• 🚀 Fleet Deployment — SSH-based push to all registered Pis in parallel

Quick Install

curl -fsSL cli.rapold.io | bash

The installer will ask you to choose your agent (ÆON or ÆTHRA) and set everything up.

Manual Install

git clone https://github.com/rapoldio/cli.git ~/rapoldio-cli
cd ~/rapoldio-cli
chmod +x aeon aethra
./install.sh

Usage

# Launch dashboard (as your chosen agent)
aeon dashboard
aethra dashboard

# Force a resolution profile
aeon --profile uhd dashboard

# System status
aeon status

# Fleet management
aeon deploy all
aeon config host add pi-living 192.168.1.10

# Configuration
aeon config show
aeon config edit

Architecture

rapoldio-cli/
├── aeon                         # ÆON agent entrypoint
├── aethra                       # ÆTHRA agent entrypoint
├── lib/
│   ├── main.sh                  # Shared CLI framework (sourced by entrypoints)
│   ├── core.sh                  # Colors, logging, box drawing, helpers
│   ├── config.sh                # YAML config management (~/.rapoldio/)
│   ├── detect.sh                # Resolution & hardware auto-detection
│   └── ssh.sh                   # SSH/rsync fleet management helpers
├── modules/
│   ├── dashboard/
│   │   ├── module.sh            # Dashboard launcher (agent-aware)
│   │   ├── top_bar.sh           # Matrix rain + figlet header
│   │   ├── right_panel.sh       # Markets, news, weather, clocks
│   │   ├── status_panel.sh      # Local system status fallback
│   │   ├── panels/
│   │   │   ├── shared/          # News, Weather, Crypto, Clock, System
│   │   │   ├── aeon/            # ÆON-specific (tasks, status)
│   │   │   └── aethra/          # ÆTHRA-specific (tasks, status)
│   │   └── profiles/            # Resolution configs (sd/hd/fhd/qhd/uhd)
│   ├── status/                  # System & fleet status
│   ├── deploy/                  # SSH fleet deployment
│   └── config/                  # Configuration management
├── install.sh                   # Multi-agent installer
├── profiles/                    # Theme profiles
└── docs/                        # Documentation

Configuration

Config lives in ~/.rapoldio/:

File	Description
config.yaml	Main config (agent, gateway, theme, modules)
hosts.yaml	Pi fleet registry
cache/	API response cache

Environment Variables

Variable	Description	Default
AGENT_ID	Active agent identity	from config
RCLI_CONFIG_DIR	Config directory	~/.rapoldio
RCLI_PROFILE	Force resolution profile	auto-detect
RCLI_DEBUG	Enable debug logging	0

Tech Stack

Layer	Technology
Shell	Bash 5.x — CLI framework, module loader, tmux orchestration
Rendering	Python 3.9+ — Matrix rain, chart rendering, data formatting
Terminal	tmux — Multi-pane dashboard layout
Data	CoinGecko, Open-Meteo, RSS — Markets, weather, news
Remote	SSH / rsync — Fleet management
Platform	Raspberry Pi OS

Contributing

See CONTRIBUTING.md. In short:

1. Fork → feature branch → PR
2. Follow plugin conventions in docs/MODULES.md
3. Run shellcheck on scripts

License

MIT

---

v2.0.0 · Made with 🤝 by ÆON & ÆTHRA