@scrylog/cli 0.3.1 → 0.4.0

package/README.md

@@ -167,6 +167,16 @@ scrylog --include-unknown
 
 By default, sessions whose tool could not be identified (`tool: "unknown"`) are hidden from the dashboard and API. Launch with `--include-unknown` to request them from the daemon for the current run.
 
+The dashboard header layout is configurable through `tui.headerLayout`, and the setup wizard prompts for the same preference:
+
+| Value | Behavior |
+| --- | --- |
+| `auto` | Uses a right or left sidebar below 33 rows when the terminal is at least 64 columns wide; otherwise uses the horizontal header. |
+| `horizontal` | Always keeps the header above Sessions and Usage. |
+| `vertical` | Always uses the 15-column sidebar, even below 64 columns. |
+
+Set `tui.headerSide` to `left` or `right` to place the vertical header. The value is retained but ignored while the resolved layout is horizontal. While the sidebar is active, the tab row displays a compact colored `scrylog` label opposite Sessions and Usage. A forced vertical layout can significantly reduce or clip session content on narrow terminals.
+
 Keyboard shortcuts:
 
 | Key | Action |
@@ -335,6 +345,9 @@ Example config:
     "showStandalone": true,
     "usePushUpdates": true,
     "standaloneMaxAgeHours": 6,
+    "pushDebounceMs": 120,
+    "headerLayout": "auto",
+    "headerSide": "left",
     "providerIcons": "blocks"
   },
   "mcp": {
@@ -372,6 +385,8 @@ Notes:
 - `daemon.commandTimeoutMs` bounds daemon-owned commands such as `ps`, `tmux`, `git`, `lsof`, and `pgrep`.
 - `daemon.networkTimeoutMs` bounds daemon-owned usage/integration network requests.
 - `usage.enabled: false` disables periodic Claude/OpenCode usage probes without disabling session monitoring.
+- `tui.headerLayout` accepts `auto` (default), `horizontal`, or `vertical`. Automatic mode uses a sidebar only below 33 rows and at 64 columns or wider; fixed vertical mode intentionally ignores that width guard.
+- `tui.headerSide` accepts `left` (default) or `right` and only affects the vertical header. `scrylog setup` persists both header preferences.
 - In the dashboard, use `Tab`, `u`, or `s` to switch between Sessions and Usage. Every usage window uses the complete card width. When provider cards exceed the terminal height, scroll with `↑`/`↓`, `j`/`k`, Page Up/Page Down, or the mouse wheel. `tui.providerIcons` accepts `blocks` (portable pixel-art PNGs, the default), `graphics` (official artwork with automatic kitty/Sixel negotiation), `kitty` or `sixel` (force a specific image protocol), or `text` (two-letter monogram); all assets are bundled for offline rendering. See [Terminal icon rendering](#terminal-icon-rendering) for environment compatibility.
 - `retention` limits in-memory state. Active `working` and `waiting-input` sessions are preserved even when old.
 - `retention` applies only to standalone sessions: tmux and herdr panes are never pruned by age or count, and `tool: "unknown"` sessions do not consume `retention.maxSessions` capacity (unknown standalone sessions are still pruned by age).