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

rapoldio CLI

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

---

Overview

TL;DR — Bash/tmux toolkit to run ÆON/ÆTHRA dashboards on Raspberry Pis and push updates to the whole fleet over SSH. Repository: marcelrapold/mra-cli (renamed from marcelrapold/cli on 2026-10-12; old URLs redirect).

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 https://raw.githubusercontent.com/marcelrapold/mra-cli/main/install.sh | bash

The short alias cli.rapold.io is currently not served (TLS handshake fails), so use the raw GitHub URL above.

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

Manual Install

git clone https://github.com/marcelrapold/mra-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