diff --git a/README.md b/README.md index 4b03eec..b6fb98b 100644 --- a/README.md +++ b/README.md @@ -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, - kolejka czekająca na koniec tury agenta, - historia i ulubione, +- dock z przyciskami do często wysyłanych komend (np. `/handoff`), - podpowiedzi `/` i `@`, - 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) | | `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 | +| `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; 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` | **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 diff --git a/herdr/herdr-composer/RECIPE.md b/herdr/herdr-composer/RECIPE.md index e60f298..6191a45 100644 --- a/herdr/herdr-composer/RECIPE.md +++ b/herdr/herdr-composer/RECIPE.md @@ -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 (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 - 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 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; @@ -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 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 -nothing, Tab switches tab, Ctrl+D or a right click stars a row, Esc or the x closes. The -star next to the field stars the text in it (100 favourites). +nothing, Tab switches tab, Ctrl+D stars a row at once, a right click opens a menu (Wstaw, +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 @@ -112,12 +124,12 @@ a `focus` border in `accent`. view), `state.js` (drafts, attachments, queue; pure), `delivery.js` (sending, the gate, countdown rules), `storage.js` (the shared store, migration from `ovis-composer.*`), `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`). **Herdr API:** `agents`, `panes`, `focused`, `theme`, `settings` (`zoom`), `appHome`, `shared`/`setShared` (the store: `herdr-composer.history`, `.favorites`, `.usage`, -`.userMin`, `.draft:
`, `.queue:`), `notify` (toast, only for a failed +`.userMin`, `.dock`, `.draft:`, `.queue:`), `notify` (toast, only for a failed 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, 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). - 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, - 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 changes of `main`. - 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 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. +- 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.