← ClaudeAtlas

qol-plugin-cli-sessionslisted

Use when working on the qol-tray CLI Sessions plugin. Covers live terminal session discovery, the per-tool interpretation strategy registry, the session status state machine, screen and title signals, the always-on-top gpui overview panel, snapshots, and daemon reconciliation. Triggers on "plugin-cli-sessions", "cli sessions", session overview, needs-you or your-turn status, Kitty remote control, or terminal attention tracking.
qol-tools/qol-skills · ★ 0 · AI & Automation · score 62
Install: claude install-skill qol-tools/qol-skills
# qol-plugin-cli-sessions CLI Sessions owns an always-on-top overview of live CLI sessions and the attention policy that decides which one needs the user. Terminal identity, discovery, screen reading, and focus are consumed from the shared terminal-sessions library; this plugin owns interpretation and presentation. ## Contract sources - `plugin.toml` owns actions, exported launcher shortcuts, daemon metadata, declared capabilities, platform availability, and release artifacts. - `qol-config.toml` owns settings sections, fields, and defaults. - `qol-runtime.toml` owns the runnable action contract. - `Cargo.toml` owns target-scoped dependencies. ## Source ownership | Path | Responsibility | |---|---| | `src/cli.rs` | Headless command surface and doctor registration. | | `src/host/` | Terminal-host boundary; the implemented host drives Kitty remote control. | | `src/session/` | Session identity, registry, tool classification, status, and git context. | | `src/strategy/` | Per-tool interpretation: the trait, its generic default, and tool-specific enrichers. | | `src/signal/` | Screen and title evidence used to detect prompts and input requests. | | `src/daemon/` | Reconcile loop and action dispatch. | | `src/storage/` | Session-state persistence, paths, and snapshots. | | `src/diagnostics/` | Anomaly detection and snapshot capture. | | `src/ui/` | gpui overview panel: placement, rendering, navigation, selection, notification. | | `src/doctor/` | Read-only checks with target-