docs: composer dock in README and RECIPE
Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
1 parent
3c65a4f577
commit
fa44ec0bf7
2 files changed
+30
-9
No files matched your search
@@ -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
|
||||||
|
|
||||||
|
|||||||
@@ -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.
|
||||||
Reference in new issue
Block a user