docs: herdr-sidebar setup — установка плагина, Nerd Font, статус проекта

WALKTHROUGH.md

@@ -58,4 +58,42 @@ https://webdav.yandex.ru  /mnt/yandex-disk  davfs  _netdev,auto,rw,uid=1000,file
 ### Артефакты
 - Статус: STATUS.md
 - Задачи: TODO.md
-- Пост для блога: (опыт был подготовлен как техноблог-пост в сессии)
+- Пост для блога: (опыт был подготовлен как техноблог-пост в сессии)
+
+---
+
+## 2026-09-10 — herdr: установка плагина herdr-sidebar
+
+### Задача
+Поставить плагин alexarthurs/herdr-sidebar (VS Code-style сайдбар для herdr) и разобраться с особенностями установки.
+
+### Ход работы
+1. `herdr plugin install alexarthurs/herdr-sidebar` → ошибка `No such file or directory (os error 2)`.
+   - Причина: монорепо — плагин в поддиректории. Правильная команда:
+     ```
+     herdr plugin install alexarthurs/herdr-sidebar/plugins/herdr-sidebar --yes
+     ```
+2. Установка прошла, но `herdr plugin list` под пользователем estorozhenko показал «No plugins installed».
+   - **Причина (важный кейс):** herdr хранит конфиг/плагины в `$HOME/.config/herdr/` — привязка к `$HOME`, а не к бинарю. Я ставил с `HOME=/opt/hermes/.hermes/home` (сессия агента), поэтому плагин ушёл в `/opt/hermes/.hermes/home/.config/herdr/`, а пользователь смотрит в `/home/estorozhenko/.config/herdr/`.
+   - Лечение: переустановка от имени пользователя:
+     ```
+     sudo -u estorozhenko -H /home/estorozhenko/.local/bin/herdr plugin install alexarthurs/herdr-sidebar/plugins/herdr-sidebar --yes
+     ```
+   - Проверка: `sudo -u estorozhenko -H /home/estorozhenko/.local/bin/herdr plugin list` → `herdr-sidebar (enabled)`.
+3. Nerd Font: при первом запуске бинарь herdr-sidebar спрашивает про JetBrainsMono Nerd Font. Встроенная установка упала: в системе нет `unzip` (exit 127), а бинарь вызывает его.
+   - Лечение вручную (python3 вместо unzip):
+     ```
+     curl -fsSL https://github.com/ryanoasis/nerd-fonts/releases/latest/download/JetBrainsMono.zip -o /tmp/jbm.zip
+     python3 -c "import zipfile; zipfile.ZipFile('/tmp/jbm.zip').extractall('/home/estorozhenko/.local/share/fonts')"
+     sudo -u estorozhenko -H fc-cache -f /home/estorozhenko/.local/share/fonts
+     ```
+   - Проверка: `sudo -u estorozhenko -H fc-list | grep -i "JetBrainsMono Nerd"` — найден (96 TTF, Nerd Font + Mono).
+
+### Выводы / правила на будущее
+1. Устанавливать herdr-плагины ТОЛЬКО от имени пользователя, который реально пользуется herdr (иначе «No plugins installed» из-за привязки к `$HOME/.config/herdr`).
+2. Монорепо-плагины: путь указывается с поддиректорией `owner/repo/subdir`.
+3. Встроенный установщик Nerd Font плагина требует `unzip` в системе; при его отсутствии ставить шрифт вручную через python3 zipfile + fc-cache от нужного пользователя.
+4. Сам факт установки шрифта НЕ меняет профиль терминала — иконки в TUI появятся, но активный шрифт терминала (где сидит herdr) должен быть Nerd Font, иначе глифы будут квадратиками.
+
+### Артефакты
+- Пост для техблога про herdr и плагины подготовлен: /tmp/herdr-post.md