Muara Skins

Terminal Skin Pack & Theme Studio untuk Hermes Agent
Koleksi tema visual, palet pelabuhan malam (Harbor Night), maskot pixel-art Mura, dan installer interaktif untuk seluruh profil Hermes.

---

Sekilas

Muara Skins menghadirkan identitas visual ekosistem Muara AI ke dalam terminal Hermes Agent. Menggunakan Hermes native skin engine (hermes skin), skin ini langsung merender palet cyan-harbor, banner logo ASCII MUARA, maskot Mura (16×16 half-block ANSI), serta spinner arus saat agen berpikir.

Semua perubahan bersifat live-reload: gateway Hermes memperbarui tampilan aktif dalam ~1 detik tanpa perlu restart sesi.

---

Fitur Utama

• Palet Harbor Night & Cyan: Kontras tinggi dengan latar #04121e / #071a2b, aksen #00e5ff, dan status #3ef0a5 / #ffc85f / #ff6b7d.
• Maskot Mura (16×16 Pixel-Art): 6 state emosi (welcome, maintenance, search, offline, done, presensi) terintegrasi langsung pada banner_hero.
• Spinner Tema Arus: Animasi putar native dengan glyph ombak (≈) (∿) (Ψ) (≋), wings ⟪≈≈⟫, serta 14 kata kerja tematik bahasa Indonesia.
• Branding Bersih: Menggunakan glyph mono ≈ Muara (bukan emoji) sehingga border respons terminal tidak mengalami salah lurus (misalignment).
• Installer Interaktif: Menu terminal terpandu berbasis angka (ala Oh My Hermes) dengan validasi fail-safe dan penulisan konfigurasi atomik.
• Font & Alacritty Auto-Setup: Bundel resmi JetBrains Mono (TrueType) dan pembaruan konfigurasi Alacritty otomatis dengan pencadangan (.bak).
• Command muara-skin: Akses cepat ke pengelola tema dari direktori mana pun di terminal.

---

Instalasi Cepat

1. Mode Interaktif (Rekomendasi)

Jalankan installer langsung di terminal interaktif untuk membuka menu pemilihan:

git clone https://github.com/MuaraAI/Skins.git
cd Skins
./install.sh

Menu akan menampilkan opsi pemasangan ke semua profil, pemilihan profil spesifik, aktivasi instan, instalasi font, hingga pratinjau pose maskot secara langsung.

2. Mode Flag (Non-Interaktif / Skrip)

# Pasang ke semua profil Hermes (~/.hermes/profiles/*)
./install.sh

# Pasang sekaligus aktifkan di semua profil
./install.sh --use

# Pasang ke satu profil spesifik
./install.sh --profile curzy-code --use

# Pasang font JetBrains Mono & perbarui alacritty.toml
./install.sh --fonts

---

Penggunaan

Perintah muara-skin

Setelah instalasi pertama, utilitas muara-skin terpasang di ~/.local/bin/muara-skin (jalur repo otomatis tertanam):

muara-skin                          # Buka menu interaktif
muara-skin --use                    # Pasang dan aktifkan ke semua profil
muara-skin --profile curzy-student  # Pasang dan aktifkan ke profil student
muara-skin --fonts                  # Pasang font JetBrains Mono

Mengelola Skin via CLI Hermes

Skin ini sepenuhnya kompatibel dengan sub-perintah bawaan Hermes:

hermes skin list           # Melihat daftar skin (muara ditandai '*')
hermes skin use muara      # Mengaktifkan skin muara
hermes skin use default    # Kembali ke skin bawaan Hermes

---

Kustomisasi Maskot Mura

State matriks maskot didefinisikan pada skins/muara/mascot.json. Anda dapat mengganti pose yang tampil pada banner hero secara bebas:

# Lihat pratinjau ANSI warna asli di terminal
python3 tools/build.py --preview --pose done

# Injeksi pose tertentu ke skins/muara/skin.yaml
python3 tools/build.py --write --pose done

# Sebarkan pembaruan ke profil yang terpasang
./install.sh

Daftar state yang tersedia: welcome (bawaan), maintenance, search, offline, done, presensi.

---

Matriks Kompatibilitas

Komponen	Linux	macOS	Windows	Catatan
Skin YAML (skin.yaml)	Ya	Ya	Ya	Dibaca langsung oleh runtime Hermes di semua OS.
Tooling (install.sh, menu)	Ya	Ya	WSL / Git Bash	Menggunakan interpreter Bash & Python 3 standar.
Font Auto-Setup (--fonts)	Ya	Ya	Manual	Memperbarui fc-cache dan konfigurasi Alacritty Unix path.

Persyaratan Terminal: Memerlukan terminal emulator dengan dukungan 24-bit Truecolor dan font monospace yang mendukung karakter Unicode block element (▀, ▄). Direkomendasikan: Alacritty, Kitty, WezTerm, iTerm2, atau Windows Terminal.

---

Struktur Repositori

MuaraAI/Skins/
├── README.md              # Dokumentasi & panduan penggunaan
├── install.sh             # Skrip instalasi & routing menu (POSIX Bash)
├── public/
│   └── mura.svg           # Aset vektor maskot Mura
├── fonts/                 # Bundel font JetBrains Mono (TTF, SIL Open Font License)
│   ├── JetBrainsMono-Regular.ttf
│   ├── JetBrainsMono-Bold.ttf
│   ├── JetBrainsMono-Italic.ttf
│   ├── JetBrainsMono-BoldItalic.ttf
│   └── OFL.txt
├── skins/
│   └── muara/
│       ├── skin.yaml      # Definisi tema lengkap untuk Hermes
│       └── mascot.json    # Definisi pixel matrix 16×16 untuk 6 state Mura
└── tools/
    ├── build.py           # Generator banner Rich-markup dari mascot matrix
    └── menu.py            # Menu interaktif terminal (Python stdlib, zero-dependency)

---

Lisensi

• Hak Cipta Kode & Tema © 2026 Muara AI.
• Font JetBrains Mono dilisensikan di bawah SIL Open Font License 1.1.