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

+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
(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:<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})`,
`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.