docs: composer dock in README and RECIPE

Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
FactorandClaude Opus 5.5 committed 2026-11-19 16:14:39 +01:00
1 parent 3c65a4f577
commit fa44ec0bf7
2 files changed
+30 -9

No files matched your search

+9 -3
View File
@@ -5,6 +5,7 @@ Pasek wiadomości dla agentów w [Herdr](https://herdr.dev). Jedno pole pod term
- drafty per agent, które przetrwają restart, - drafty per agent, które przetrwają restart,
- kolejka czekająca na koniec tury agenta, - kolejka czekająca na koniec tury agenta,
- historia i ulubione, - historia i ulubione,
- dock z przyciskami do często wysyłanych komend (np. `/handoff`),
- podpowiedzi `/` i `@`, - podpowiedzi `/` i `@`,
- jeden sposób dodawania załączników: upuszczenie, przycisk `+`, Ctrl+V. - jeden sposób dodawania załączników: upuszczenie, przycisk `+`, Ctrl+V.
@@ -65,13 +66,18 @@ Usuwa `mods\herdr-composer`, `layouts\herdr-composer.json` i skrót z `keys.json
| `Alt+Enter` | do kolejki jako wstrzymana (wyślesz ręcznie) | | `Alt+Enter` | do kolejki jako wstrzymana (wyślesz ręcznie) |
| `Esc` | zamyka menu lub panel; przy pustym polu przerywa pracującego agenta | | `Esc` | zamyka menu lub panel; przy pustym polu przerywa pracującego agenta |
| `/`, `@` | podpowiedzi komend, skilli i plików; `↑` `↓` wybór, `Enter`/`Tab` wstaw | | `/`, `@` | 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 | | `Ctrl+R` albo 🕘 | panel Historia / Ulubione: `↑` `↓`, `Enter` wstawia w miejscu kursora (bez wysyłania), `Tab` przełącza zakładki, `Ctrl+D` dodaje do ulubionych, `Esc` lub ✕ zamyka |
| ☆ | zapisuje bieżący tekst w ulubionych | | ☆ | zapisuje bieżący tekst w ulubionych; prawy klik przypina go do docka |
| dock (przyciski za ☆) | klik wysyła zapisany tekst do agenta (jak Enter, przez kolejkę) albo, w trybie ✎, wstawia go w miejscu kursora; tekst w polu zostaje |
| prawy klik na przycisk docka | Zmień nazwę, Tylko wstawiaj / Wysyłaj od razu, Przesuń w lewo / w prawo, Usuń z docka |
| prawy klik na wiersz panelu | Wstaw, Dodaj do ulubionych / Usuń z ulubionych; w Ulubionych także Przypnij do docka / Odepnij z docka |
| `+`, upuszczenie pliku, `Ctrl+V` obrazu | załącznik: kopiowany do agenta przez `hc put` i dopisywany jako `@ścieżka` | | `+`, 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`). **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. **Dock:** wspólny dla wszystkich agentów, do 30 przycisków. Przyciski dodajesz prawym klikiem na wpis w Ulubionych („Przypnij do docka”) albo na ☆ (bieżący tekst). Gdy przycisków jest dużo, dock przewija się w bok.
**Dane:** historia (500 wpisów), ulubione (100), dock (30 przycisków), 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 ## Co mod uruchamia i czyta
+21 -6
View File
@@ -32,7 +32,10 @@ The window is the `main` layout with one block added. Left to right, top to bott
5. **the card** (rounded 12, 1 px `border`, `raised` background): attachment tiles 5. **the card** (rounded 12, 1 px `border`, `raised` background): attachment tiles
(44 px high: 36 px thumbnail or extension, name, size or reason, "Ponów", x), the (44 px high: 36 px thumbnail or extension, name, size or reason, "Ponów", x), the
field (`background`, rounded 8, 13 px, 1 to 10 rows), and a row of controls: three field (`background`, rounded 8, 13 px, 1 to 10 rows), and a row of controls: three
28 px round buttons `+`, a clock, a star; a flexible gap; the agent pill (rounded 12: 28 px round buttons `+`, a clock, a star; a 1x18 px divider; **the dock** (flexible,
28 px high, scrolls sideways: one 28 px button per saved text, rounded 8, 12 px; a
send button on `chrome`, an insert button with a 1 px dashed `border` and a `✎`
prefix; empty: "Prawy klik w Ulubionych → Przypnij do docka" in `dim`); the agent pill (rounded 12:
a 7 px status dot, the tab's name, the status word, a paperclip and the count when a 7 px status dot, the tab's name, the status word, a paperclip and the count when
files are attached); and a 32 px round button, a white arrow to send, or a white files are attached); and a 32 px round button, a white arrow to send, or a white
square (Stop) when the field is empty and the agent works; square (Stop) when the field is empty and the agent works;
@@ -94,8 +97,17 @@ other than `claude-code`, `codex`, `gemini`, `opencode` asks first ("Anuluj" / "
**History and favourites.** Every message that `hc send` accepted is stored (500, newest **History and favourites.** Every message that `hc send` accepted is stored (500, newest
first, any space or agent). In the panel: type to search (case-insensitive, Polish letters first, any space or agent). In the panel: type to search (case-insensitive, Polish letters
too), Up/Down, Enter inserts at the caret the field had when the panel opened and sends too), Up/Down, Enter inserts at the caret the field had when the panel opened and sends
nothing, Tab switches tab, Ctrl+D or a right click stars a row, Esc or the x closes. The nothing, Tab switches tab, Ctrl+D stars a row at once, a right click opens a menu (Wstaw,
star next to the field stars the text in it (100 favourites). Dodaj do ulubionych / Usuń z ulubionych; in Favourites also Przypnij do docka / Odepnij
z docka), Esc or the x closes. The star next to the field stars the text in it (100
favourites); a right click on it pins the text to the dock.
**Dock.** A row of buttons in the bar, one dock for every agent (30 at most). A click on a
send button sends its text the way Enter does (queue, countdown, `--force` when blocked)
and leaves the field, the draft and the files alone; an insert button puts its text at
the caret. A right click on a button: Zmień nazwę (in place: Enter keeps, Esc drops; an
empty name falls back to the first 15 characters + "…"), Tylko wstawiaj / Wysyłaj od
razu, Przesuń w lewo / w prawo, Usuń z docka. Without an agent the buttons are dimmed.
## Built from ## Built from
@@ -112,12 +124,12 @@ a `focus` border in `accent`.
view), `state.js` (drafts, attachments, queue; pure), `delivery.js` (sending, the gate, view), `state.js` (drafts, attachments, queue; pure), `delivery.js` (sending, the gate,
countdown rules), `storage.js` (the shared store, migration from `ovis-composer.*`), countdown rules), `storage.js` (the shared store, migration from `ovis-composer.*`),
`history.js`, `attachments.js`, `clipboard.js`, `suggest.js`, `catalog.js`, `keys.js`, `history.js`, `attachments.js`, `clipboard.js`, `suggest.js`, `catalog.js`, `keys.js`,
`view.js` (helpers), `panel.js` (the panel and the preview). The pure modules import nothing `dock.js` (the dock and its menus; pure), `view.js` (helpers), `panel.js` (the panel and the preview). The pure modules import nothing
from Herdr and are tested with Node (`npm test`). from Herdr and are tested with Node (`npm test`).
**Herdr API:** `agents`, `panes`, `focused`, `theme`, `settings` (`zoom`), `appHome`, **Herdr API:** `agents`, `panes`, `focused`, `theme`, `settings` (`zoom`), `appHome`,
`shared`/`setShared` (the store: `herdr-composer.history`, `.favorites`, `.usage`, `shared`/`setShared` (the store: `herdr-composer.history`, `.favorites`, `.usage`,
`.userMin`, `.draft:<address>`, `.queue:<address>`), `notify` (toast, only for a failed `.userMin`, `.dock`, `.draft:<address>`, `.queue:<address>`), `notify` (toast, only for a failed
send or `hc` call), `nextCommand`, `run("layout.resize", {id: "composer", px})`, send or `hc` call), `nextCommand`, `run("layout.resize", {id: "composer", px})`,
`cx.bind_keys` in the context `herdr-composer > Input` (up, down, tab, ctrl-r, `cx.bind_keys` in the context `herdr-composer > Input` (up, down, tab, ctrl-r,
ctrl-enter, alt-enter, escape), `fs/promises` (the paste folder), gpui-kit and gpui-base ctrl-enter, alt-enter, escape), `fs/promises` (the paste folder), gpui-kit and gpui-base
@@ -163,7 +175,7 @@ It makes no network request.
copies them, so it reloads the mod). copies them, so it reloads the mod).
- Windows only: the clipboard, the `+` dialog and the file sizes use PowerShell. - Windows only: the clipboard, the `+` dialog and the file sizes use PowerShell.
- Limits: 20 000 characters a message, 32 MiB a file, 100 files a message, history 500, - Limits: 20 000 characters a message, 32 MiB a file, 100 files a message, history 500,
favourites 100, the menu shows 20 rows. favourites 100, the dock 30 buttons, the menu shows 20 rows.
- The layout is a clone: it keeps the look of `main` as of 0.1.16 and does not follow later - The layout is a clone: it keeps the look of `main` as of 0.1.16 and does not follow later
changes of `main`. changes of `main`.
- Data kept under `ovis-composer.*` by the earlier name is read when the new key is empty - Data kept under `ovis-composer.*` by the earlier name is read when the new key is empty
@@ -183,4 +195,7 @@ It makes no network request.
- Ctrl+R opens the panel with the sent messages; search lights the match; Enter inserts at - Ctrl+R opens the panel with the sent messages; search lights the match; Enter inserts at
the caret and sends nothing; Esc closes it and the block returns to its height. the caret and sends nothing; Esc closes it and the block returns to its height.
- Ctrl+Shift+Space focuses the field; clicking a terminal gives that terminal the keys. - Ctrl+Shift+Space focuses the field; clicking a terminal gives that terminal the keys.
- A right click on a Favourites row pins it to the dock; a click on the button sends it
and leaves the draft; a right click on the button renames, moves, switches the mode and
removes it; the dock survives a reload.
- `npm test` passes. - `npm test` passes.