Co-Authored-By: Ovis Fast (Claude) <[email protected]>
herdr-composer
Pasek wiadomości dla agentów w Herdr. Jedno pole pod terminalem pisze do agenta, który ma fokus. Do tego:
- drafty per agent, które przetrwają restart,
- kolejka czekająca na koniec tury agenta,
- historia i ulubione,
- podpowiedzi
/i@, - jeden sposób dodawania załączników: upuszczenie, przycisk
+, Ctrl+V.
Wymagania
- Windows. Przycisk
+i wklejanie obrazów przez Ctrl+V używają PowerShell. Reszta działa wszędzie, gdzie działa Herdr. - Herdr (
herdr-app,hc) wPATH. Sprawdzone na herdr-core 0.1.21. - Git z dostępem do
http://git.mkali.pl/Factor/herdrMario.git(repo prywatne). Klonowanie użyje Twoich zapisanych poświadczeń. - Do testów: Node.js ≥ 20.
Instalacja
Obie drogi dają ten sam wynik.
1. Przez agenta (tak jak layouty z herdr.dev). Wklej agentowi w Herdr:
Read ~/.config/herdr-app/AGENTS.md, then add this layout: clone http://git.mkali.pl/Factor/herdrMario.git and use the folder herdr/herdr-composer
2. Jedną komendą (cmd):
git clone http://git.mkali.pl/Factor/herdrMario.git "%USERPROFILE%\herdrMario" && "%USERPROFILE%\herdrMario\install.cmd"
install.cmd uruchamia scripts\install.ps1 z -ExecutionPolicy Bypass, tylko dla tego jednego wywołania. Działa więc także tam, gdzie uruchamianie skryptów .ps1 jest wyłączone. Instalator:
- Aktualizuje repo: robi
git pull --ff-only, ale tylko w czystym klonie. Błąd pull to ostrzeżenie, nie przerwanie. - Kopiuje mod i layout: mod trafia do
~\.config\herdr-app\mods\herdr-composer(kopia lustrzana), layout dolayouts\herdr-composer.json. Herdr sam wczytuje nowe pliki. Jeśli istnieje inny layout o tej nazwie, najpierw robi jego kopię zapasową. - Dopisuje skrót do Twojego
keys.json:ctrl-shift-spaceprzenosi fokus do composera. Przed zapisem robi kopię. Klawisza, który masz przypisany do czegoś innego, nie rusza i wypisuje ostrzeżenie. Formatowaniekeys.jsonsię zmienia, znaczenie nie. - Usuwa poprzednią wersję
ovis-composer: junction albo katalog modu, layout i skrót. Historia, ulubione, drafty i kolejki zostają (patrz Przejście z ovis-composer). - Sprawdza i przełącza: uruchamia
herdr-app check. Na layoutherdr-composerprzełącza tylko przy pierwszej instalacji albo wtedy, gdy aktywny byłovis-composer. W pozostałych przypadkach podpowiadactrl-shift-l.
Wszystkie kopie zapasowe trafiają do ~\.config\herdr-app\backups\herdr-composer\<rrrrMMdd-HHmmss>\, nigdy do mods\ ani layouts\, bo Herdr wczytałby je jako mod lub layout. Pliki repo nigdy nie są usuwane.
Aktualizacja
Uruchom ponownie install.cmd albo poproś agenta jeszcze raz. Herdr sam przeładuje mod, bez restartu.
Odinstalowanie
install.cmd -Uninstall
Usuwa mods\herdr-composer, layouts\herdr-composer.json i skrót z keys.json, a potem przełącza na layout main. Zostają tylko kopie w backups\herdr-composer\.
Użycie
| Klawisz / akcja | Co robi |
|---|---|
klik w pole, Ctrl+Shift+Space |
fokus w composerze (klik w terminal oddaje klawiaturę terminalowi) |
Enter / Shift+Enter |
wyślij / nowa linia |
Ctrl+Enter |
wyślij teraz, z pominięciem kolejki |
Alt+Enter |
do kolejki jako wstrzymana (wyślesz ręcznie) |
Esc |
zamyka menu lub panel; przy pustym polu przerywa pracującego agenta |
/, @ |
podpowiedzi komend, skilli i plików; ↑ ↓ wybór, Enter/Tab wstaw |
Ctrl+R albo 🕘 |
panel Historia / Ulubione: ↑ ↓, Enter wstawia w miejscu kursora (bez wysyłania), Tab przełącza zakładki, Ctrl+D lub prawy klik dodaje do ulubionych, Esc lub ✕ zamyka |
| ☆ | zapisuje bieżący tekst w ulubionych |
+, upuszczenie pliku, Ctrl+V obrazu |
załącznik: kopiowany do agenta przez hc put i dopisywany jako @ścieżka |
Kolejka: gdy agent pracuje, Enter dodaje wiadomość do kolejki. Po zakończeniu tury pojawia się odliczanie 3 s z przyciskiem Anuluj, a potem wiadomość wychodzi. Stop albo Esc wstrzymuje całą kolejkę. Gdy agent czeka na Twoją odpowiedź (blocked), Enter wysyła ją od razu (hc send --force).
Dane: historia (500 wpisów), ulubione (100), drafty i kolejki zapisują się lokalnie w ~\.config\herdr-app\shared.json (klucze herdr-composer.*). Obrazy ze schowka trafiają do ~\.config\herdr-app\data\herdr-composer\paste\ i są usuwane po 7 dniach. Nic nie jest wysyłane poza ten komputer.
Co mod uruchamia i czyta
Agent instalujący paczkę poinformuje o tym przed instalacją.
hc:send,put,get,interrupt,keys. Tak mod rozmawia z terminalami agentów.powershell: odczyt schowka, okno wyboru pliku, rozmiary plików, odczyt komend i skilli z.claude/projektu. Ścieżki trafiają do skryptów wyłącznie jako Base64.git ls-filesw folderze agenta: podpowiedzi@.- Pliki spoza folderu modu: pliki, które sam dodajesz jako załączniki, oraz
.claude/commandsi.claude/skillsprojektu. - Sieć: mod nie korzysta z sieci.
Przejście z ovis-composer
Wcześniejsza wersja nazywała się ovis-composer. Instalator usuwa ją automatycznie. Mod przy pierwszym odczycie przenosi dane z kluczy ovis-composer.* do herdr-composer.*; starych kluczy nie kasuje. Instalator nie rusza starych kopii mods\ovis-composer.bak-* i layouts\ovis-composer.json.bak-*. Możesz je usunąć ręcznie.
Rozwiązywanie problemów
- Composer się nie pokazuje: sprawdź
herdr-app status. Pole"layout"powinno mieć wartośćherdr-composer, a"errors"powinno być puste. Layout przełączysz przezctrl-shift-l. - Mod nie reaguje po zmianie plików: uruchom ponownie
install.cmd. Herdr widzi tylko pliki w~\.config\herdr-app\mods\, a nie te w repo. Ctrl+Shift+Spacenie działa: sprawdź, czy w~\.config\herdr-app\keys.json(sekcjaglobal) jest"ctrl-shift-space": "herdr-composer.focus"i czy obok nie powstał plikkeys.error.- Coś nie gra po instalacji:
install.cmd -Uninstall, a potem przywróć potrzebny plik zbackups\herdr-composer\. Awaryjniectrl-alt-shift-escapezawsze wraca do layoutumain.
Rozwój
Struktura repo:
herdr/herdr-composer/: paczka w formacie Herdr (layouts/,mods/herdr-composer/,keys.json,RECIPE.md,preview.png).tests/: testy czystych modułów (npm test).scripts/install.ps1: instalator, wywoływany przezinstall.cmd.docs/superpowers/: specyfikacja, plany, makieta, raporty weryfikacji.
Cykl pracy: edytuj pliki w herdr/herdr-composer/mods/herdr-composer/, uruchom npm test, potem install.cmd, żeby skopiować zmianę do Herdr. Problemy pokażą herdr-app check "%USERPROFILE%\.config\herdr-app\mods\herdr-composer" i herdr-app status.
