thread-list

# Thread list preferences The Thread list plugin owns the sidebar's layout state. Read it with `bb thread-list prefs list --json`; keys are `showProviderIcons`, `threadLifecycles`, `organizationMode`, `environmentGrouping`, `chronologicalSort`, `sortDirection`, `sectionOrder`, `manualSectionOrder`, `machineSectionOrder`, `hiddenGroups` (including the built-in `threads` group), `rowActions`, `collapsedSections`, `collapsedProjects`, `collapsedThreads`, `collapsedEnvironments`, `collapsedThreadSections`, and `collapsedMachines`. ```sh bb thread-list prefs list [--json] bb thread-list prefs get <key> [--json] bb thread-list prefs set <key> <value> [--json] bb thread-list prefs reset <key> [--json] ``` `set` takes JSON; a bare word is read as a string, so `bb thread-list prefs set organizationMode machine` and `bb thread-list prefs set manualSectionOrder '["pinned","sections","threads"]'` both work. A value the key's schema rejects fails with `invalid_preference_value` and leaves the stored value alone. Every open window applies a change immediately. Sections themselves and a thread's section are bb core state: use `bb thread section` and `bb thread update`. On first load the plugin copies any non-default `sidebar.*` values from `bb settings ui` once; after that the two are independent. The header's Filter menu selects Active, Archived, or both; at least one must remain selected. `bb thread-list prefs set threadLifecycles '["archived"]'` shows archived threads, and `'["active","archived"]'` shows both. The default is `'["active"]'`. Archived results load in pages; use Show more at the end of the list. The same preference is available through `setPreference` RPC. `rowActions` picks up to three quick-action buttons a thread row shows on hover, left to right before its actions menu. Choose from `split`, `copyLink`, `read`, `pin`, `move` (opens a section menu), `rename`, and `archive`; the default is `'["archive"]'` and `'[]'` leaves only the menu. For example, `bb thread-list prefs set rowActions '["pin","archive"]'`. In the app, a thread row's actions menu has Customize row actions, which previews the row's three action slots; each slot picks an action or Hide, and filled slots drag to reorder. Organize → Rows → Provider icons toggles the icon before each thread title. `showProviderIcons` defaults to `false`; use `bb thread-list prefs set showProviderIcons true` to show them. Unknown provider ids have no icon.