@vanillagreen/pi-qol 1.0.0

package/package.json

@@ -0,0 +1,835 @@
+{
+  "name": "@vanillagreen/pi-qol",
+  "version": "1.0.0",
+  "description": "Pi quality-of-life extension: compact statusline/π prompt, reliable multiline input, styled pasted-image chips, session naming/search/context import, handoff, permission prompts, notifications, custom compaction, and a collapsed-thinking timer.",
+  "license": "MIT",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "coding-agent",
+    "qol",
+    "editor"
+  ],
+  "pi": {
+    "extensions": [
+      "./extensions/qol.ts"
+    ],
+    "image": "https://raw.githubusercontent.com/vanillagreencom/vstack/main/pi-extensions/pi-qol/assets/settings-panel.png"
+  },
+  "vstack": {
+    "extensionManager": {
+      "displayName": "QOL",
+      "settings": [
+        {
+          "key": "enabled",
+          "label": "Enable QOL editor helpers",
+          "description": "Install the QOL editor component and /qol helper command. Disable and reload to leave Pi editor behavior unchanged.",
+          "type": "boolean",
+          "default": true,
+          "category": "General",
+          "apply": "reload",
+          "requiresReload": true
+        },
+        {
+          "key": "replaceFooter",
+          "label": "Replace built-in footer",
+          "description": "Hide Pi default footer while the compact QOL statusline is active.",
+          "type": "boolean",
+          "default": true,
+          "category": "Statusline",
+          "apply": "reload",
+          "requiresReload": true
+        },
+        {
+          "key": "compactPrompt",
+          "label": "Use π prompt editor",
+          "description": "Replace the main editor with the compact π prompt editor. Disable to use QOL newline/image helpers with Pi default editor chrome.",
+          "type": "boolean",
+          "default": true,
+          "category": "Statusline",
+          "apply": "reload",
+          "requiresReload": true
+        },
+        {
+          "key": "showSessionNameTitle",
+          "label": "Show session name title",
+          "description": "Show the named session above the prompt. In tmux, update the current pane title to \"π <session>\" and enable a pane border title padded with non-breaking spaces so tmux does not trim it.",
+          "type": "boolean",
+          "default": true,
+          "category": "Statusline",
+          "apply": "reload",
+          "requiresReload": true
+        },
+        {
+          "key": "inputBottomPaddingLines",
+          "label": "Input bottom padding",
+          "description": "Blank lines below the compact prompt. Default is 0 for no extra space.",
+          "type": "number",
+          "default": 0,
+          "category": "Statusline",
+          "apply": "reload",
+          "requiresReload": true
+        },
+        {
+          "key": "gitRefreshTimeoutMs",
+          "label": "Git refresh timeout",
+          "description": "Timeout for each git metadata command used by the statusline.",
+          "type": "number",
+          "default": 1500,
+          "category": "Statusline Git",
+          "apply": "live"
+        },
+        {
+          "key": "showDirtyMarker",
+          "label": "Show dirty marker",
+          "description": "Append * to the branch badge when the worktree is dirty.",
+          "type": "boolean",
+          "default": true,
+          "category": "Statusline Git",
+          "apply": "live"
+        },
+        {
+          "key": "permissionGate.enabled",
+          "label": "Prompt before risky bash commands",
+          "description": "Ask for confirmation before bash tool calls matching the configured command list. Off by default; enable explicitly if you want this extra prompt.",
+          "type": "boolean",
+          "default": false,
+          "category": "Permission Gate",
+          "apply": "live"
+        },
+        {
+          "key": "permissionGate.commands",
+          "label": "Commands to prompt for",
+          "description": "Comma-separated command fragments to confirm before running. Literal entries are case-insensitive and whitespace-tolerant; regex entries may use /pattern/flags. Default prompts only for rm -Rf.",
+          "type": "string",
+          "default": "rm -Rf",
+          "category": "Permission Gate",
+          "apply": "live"
+        },
+        {
+          "key": "permissionGate.previewLines",
+          "label": "Approval preview lines",
+          "description": "Maximum command lines rendered in the permission approval prompt. Longer commands show a head/tail preview with an omitted-line marker.",
+          "type": "number",
+          "default": 12,
+          "category": "Permission Gate",
+          "apply": "live"
+        },
+        {
+          "key": "permissionGate.previewChars",
+          "label": "Approval preview characters",
+          "description": "Maximum command preview characters rendered in the permission approval prompt to avoid flooding or flickering the terminal.",
+          "type": "number",
+          "default": 1200,
+          "category": "Permission Gate",
+          "apply": "live"
+        },
+        {
+          "key": "newlineOnShiftEnter",
+          "label": "Shift+Enter inserts newline",
+          "description": "Intercept distinguishable Shift+Enter/Shift+Return in the prompt editor and insert a newline instead of submitting.",
+          "type": "boolean",
+          "default": true,
+          "category": "Input",
+          "apply": "reload",
+          "requiresReload": true
+        },
+        {
+          "key": "newlineFallbackKey",
+          "label": "Fallback newline key",
+          "description": "Alternate newline key for terminals that cannot distinguish Shift+Enter. Alt+Enter is reserved for Pi follow-up messages.",
+          "type": "enum",
+          "enumValues": [
+            "ctrl+j",
+            "none"
+          ],
+          "default": "ctrl+j",
+          "category": "Input",
+          "apply": "reload",
+          "requiresReload": true
+        },
+        {
+          "key": "pendingQueue.asciiGreen",
+          "label": "Green pending queue preview",
+          "description": "Render Pi's built-in steering/follow-up queue preview and Alt+Up hint in ANSI green with a left | queue bar instead of the dim hint color.",
+          "type": "boolean",
+          "default": true,
+          "category": "Input",
+          "apply": "live"
+        },
+        {
+          "key": "showImageChips",
+          "label": "Style image chips",
+          "description": "Render [Image #N] placeholders and existing pasted image paths in the editor as visually distinct chips. Pi still owns attachment state.",
+          "type": "boolean",
+          "default": true,
+          "category": "Images",
+          "apply": "live"
+        },
+        {
+          "key": "showAttachmentCountInStatus",
+          "label": "Show attachment count",
+          "description": "Show a lightweight status badge when the draft contains image placeholders.",
+          "type": "boolean",
+          "default": true,
+          "category": "Images",
+          "apply": "live"
+        },
+        {
+          "key": "enableSessionNameCommand",
+          "label": "Enable /rename command",
+          "description": "Register the /rename command for setting or viewing the current session's friendly name in Pi's session selector.",
+          "type": "boolean",
+          "default": true,
+          "category": "Session",
+          "apply": "reload",
+          "requiresReload": true
+        },
+        {
+          "key": "sessionAutoRename.enabled",
+          "label": "Auto-name new sessions",
+          "description": "Automatically generate a friendly session name from the first user prompt when the session does not already have a name.",
+          "type": "boolean",
+          "default": true,
+          "category": "Session Auto-Rename",
+          "apply": "live"
+        },
+        {
+          "key": "sessionAutoRename.model",
+          "label": "Auto-rename model",
+          "description": "Model used for title generation. Use provider/model, current, or cheapest. Default is a fast OpenAI Codex model that supports ChatGPT OAuth via /login openai-codex.",
+          "type": "string",
+          "default": "openai-codex/gpt-5.4-mini",
+          "category": "Session Auto-Rename",
+          "apply": "live"
+        },
+        {
+          "key": "sessionAutoRename.fallbackModel",
+          "label": "Auto-rename fallback model",
+          "description": "Model to try if the primary model is unavailable. Use current, provider/model, cheapest, none, or off.",
+          "type": "string",
+          "default": "current",
+          "category": "Session Auto-Rename",
+          "apply": "live"
+        },
+        {
+          "key": "sessionAutoRename.fallback",
+          "label": "Deterministic fallback",
+          "description": "Fallback naming strategy if all model calls fail: title-case words from the first prompt, a truncated prompt, or none.",
+          "type": "enum",
+          "enumValues": [
+            "words",
+            "truncate",
+            "none"
+          ],
+          "default": "words",
+          "category": "Session Auto-Rename",
+          "apply": "live"
+        },
+        {
+          "key": "sessionAutoRename.prefix",
+          "label": "Auto-rename prefix",
+          "description": "Optional static prefix added before generated names, e.g. a project label. Leave empty for no prefix.",
+          "type": "string",
+          "default": "",
+          "category": "Session Auto-Rename",
+          "apply": "live"
+        },
+        {
+          "key": "sessionAutoRename.maxInputChars",
+          "label": "Auto-rename input cap",
+          "description": "Maximum first-prompt characters sent to the naming model. Long prompts keep the beginning and end.",
+          "type": "number",
+          "default": 2000,
+          "category": "Session Auto-Rename",
+          "apply": "live"
+        },
+        {
+          "key": "sessionAutoRename.maxNameChars",
+          "label": "Auto-rename title length",
+          "description": "Maximum characters for generated session names, including any prefix.",
+          "type": "number",
+          "default": 80,
+          "category": "Session Auto-Rename",
+          "apply": "live"
+        },
+        {
+          "key": "sessionAutoRename.maxTokens",
+          "label": "Auto-rename output tokens",
+          "description": "Maximum output tokens requested from the naming model.",
+          "type": "number",
+          "default": 96,
+          "category": "Session Auto-Rename",
+          "apply": "live"
+        },
+        {
+          "key": "sessionAutoRename.timeoutMs",
+          "label": "Auto-rename timeout",
+          "description": "Per-model timeout in milliseconds before falling back to the next model or deterministic title.",
+          "type": "number",
+          "default": 12000,
+          "category": "Session Auto-Rename",
+          "apply": "live"
+        },
+        {
+          "key": "sessionAutoRename.prompt",
+          "label": "Auto-rename prompt override",
+          "description": "Optional prompt template. Use {{message}} for the first user prompt; when empty, QOL uses its built-in concise title prompt.",
+          "type": "string",
+          "default": "",
+          "category": "Session Auto-Rename Advanced",
+          "apply": "live"
+        },
+        {
+          "key": "sessionAutoRename.notify",
+          "label": "Notify on auto-rename",
+          "description": "Show a Pi UI notification when QOL auto-generates a session name. Manual /qol rename always notifies.",
+          "type": "boolean",
+          "default": false,
+          "category": "Session Auto-Rename Advanced",
+          "apply": "live"
+        },
+        {
+          "key": "sessionAutoRename.debug",
+          "label": "Debug auto-rename",
+          "description": "Show model/auth/fallback diagnostics for automatic session naming.",
+          "type": "boolean",
+          "default": false,
+          "category": "Session Auto-Rename Advanced",
+          "apply": "live"
+        },
+        {
+          "key": "enableHandoffCommand",
+          "label": "Enable /handoff command",
+          "description": "Register the handoff command to generate a focused prompt and create a new session with the prompt as a draft.",
+          "type": "boolean",
+          "default": true,
+          "category": "Session",
+          "apply": "reload",
+          "requiresReload": true
+        },
+        {
+          "key": "handoffReviewPrompt",
+          "label": "Review handoff prompt",
+          "description": "Open an editor to review or edit the generated handoff prompt before creating the new session.",
+          "type": "boolean",
+          "default": true,
+          "category": "Session",
+          "apply": "live"
+        },
+        {
+          "key": "enableContextCommand",
+          "label": "Enable /context command",
+          "description": "Register the /context command to show inline context-window usage with estimated Pi/model category breakdowns.",
+          "type": "boolean",
+          "default": true,
+          "category": "Context",
+          "apply": "reload",
+          "requiresReload": true
+        },
+        {
+          "key": "sessionSearch.enabled",
+          "label": "Enable session search",
+          "description": "Register the previous-session search palette, preview, resume, and context-import actions.",
+          "type": "boolean",
+          "default": true,
+          "category": "Session Search",
+          "apply": "reload",
+          "requiresReload": true
+        },
+        {
+          "key": "sessionSearch.shortcutKey",
+          "label": "Session search shortcut",
+          "description": "Keyboard shortcut to open the session search overlay. Default f3 avoids Pi's built-in Ctrl+F and Alt+F editor bindings. Set to none to disable.",
+          "type": "string",
+          "default": "f3",
+          "category": "Session Search",
+          "apply": "reload",
+          "requiresReload": true
+        },
+        {
+          "key": "sessionSearch.sortMode",
+          "label": "Session search sort mode",
+          "description": "Sort matches by relevance score or by most recent session modification time.",
+          "type": "enum",
+          "enumValues": [
+            "relevance",
+            "recent"
+          ],
+          "default": "relevance",
+          "category": "Session Search",
+          "apply": "live"
+        },
+        {
+          "key": "sessionSearch.resultLimit",
+          "label": "Session search result limit",
+          "description": "Maximum number of matching sessions returned by the search palette.",
+          "type": "number",
+          "default": 40,
+          "category": "Session Search",
+          "apply": "live"
+        },
+        {
+          "key": "sessionSearch.maxVisible",
+          "label": "Visible session rows",
+          "description": "Maximum number of sessions shown at once in the overlay before scrolling.",
+          "type": "number",
+          "default": 10,
+          "category": "Session Search",
+          "apply": "live"
+        },
+        {
+          "key": "sessionSearch.previewSnippets",
+          "label": "Preview snippets",
+          "description": "Maximum matching snippets shown on the selected session preview screen.",
+          "type": "number",
+          "default": 6,
+          "category": "Session Search",
+          "apply": "live"
+        },
+        {
+          "key": "sessionSearch.overlayWidth",
+          "label": "Overlay width",
+          "description": "Preferred session search overlay width in terminal columns.",
+          "type": "number",
+          "default": 104,
+          "category": "Session Search",
+          "apply": "live"
+        },
+        {
+          "key": "sessionSearch.messageMaxVisible",
+          "label": "Visible user prompt rows",
+          "description": "Maximum number of one-line user prompts shown at once in the session prompt browser before scrolling.",
+          "type": "number",
+          "default": 12,
+          "category": "Session Search",
+          "apply": "live"
+        },
+        {
+          "key": "sessionSearch.cacheTtlSeconds",
+          "label": "Session cache TTL",
+          "description": "Seconds before the in-memory session list is refreshed. Default 0 keeps the cache until you explicitly run /search refresh.",
+          "type": "number",
+          "default": 0,
+          "category": "Session Search",
+          "apply": "live"
+        },
+        {
+          "key": "sessionSearch.summaryModel",
+          "label": "Session summary model",
+          "description": "Model used to summarize an imported previous session. Use current, provider/model, or a bare model id. Defaults to current so no extra provider setup is required.",
+          "type": "string",
+          "default": "current",
+          "category": "Session Search Summary",
+          "apply": "live"
+        },
+        {
+          "key": "sessionSearch.summaryMaxTokens",
+          "label": "Session summary max output tokens",
+          "description": "Maximum tokens requested from the session-search summarizer.",
+          "type": "number",
+          "default": 4096,
+          "category": "Session Search Summary",
+          "apply": "live"
+        },
+        {
+          "key": "sessionSearch.summaryInputMaxChars",
+          "label": "Summary input character cap",
+          "description": "Maximum previous-session transcript characters sent to the summarizer; long sessions keep the beginning and end.",
+          "type": "number",
+          "default": 180000,
+          "category": "Session Search Summary",
+          "apply": "live"
+        },
+        {
+          "key": "notification.enabled",
+          "label": "Enable notifications",
+          "description": "Send terminal/tmux notifications for ready/input-needed, questions, completed task lists, and critical information.",
+          "type": "boolean",
+          "default": true,
+          "category": "Notifications",
+          "apply": "live"
+        },
+        {
+          "key": "notification.onAgentReady",
+          "label": "Notify when ready",
+          "description": "Notify when an agent turn finishes and Pi is ready for input.",
+          "type": "boolean",
+          "default": true,
+          "category": "Notifications Triggers",
+          "apply": "live"
+        },
+        {
+          "key": "notification.onDirectionNeeded",
+          "label": "Notify when direction needed",
+          "description": "Use stronger notification wording when the last assistant message appears to ask for direction, confirmation, or a choice.",
+          "type": "boolean",
+          "default": true,
+          "category": "Notifications Triggers",
+          "apply": "live"
+        },
+        {
+          "key": "notification.onQuestion",
+          "label": "Notify for question popups",
+          "description": "Notify when pi-questions opens a structured question that requires user input.",
+          "type": "boolean",
+          "default": true,
+          "category": "Notifications Triggers",
+          "apply": "live"
+        },
+        {
+          "key": "notification.onTaskComplete",
+          "label": "Notify when all tasks complete",
+          "description": "Notify after the agent turn ends when tasks_write completes the task panel.",
+          "type": "boolean",
+          "default": true,
+          "category": "Notifications Triggers",
+          "apply": "live"
+        },
+        {
+          "key": "notification.onCritical",
+          "label": "Notify critical info",
+          "description": "Notify for assistant messages containing critical, blocked, security, rate-limit, or cannot-proceed signals. Tool failures are intentionally ignored.",
+          "type": "boolean",
+          "default": true,
+          "category": "Notifications Triggers",
+          "apply": "live"
+        },
+        {
+          "key": "notification.bell",
+          "label": "Terminal bell",
+          "description": "Emit BEL (\\u0007) for standard terminal/tmux audible or visual bell behavior.",
+          "type": "boolean",
+          "default": true,
+          "category": "Notifications Channels",
+          "apply": "live"
+        },
+        {
+          "key": "notification.bellWhenActive",
+          "label": "Bell when tmux window active",
+          "description": "Also emit BEL when the source tmux window is already active. Disabled by default to avoid noisy bells while you are looking at the Pi window; native terminal notifications still run so Ghostty can decide based on app focus.",
+          "type": "boolean",
+          "default": false,
+          "category": "Notifications Channels",
+          "apply": "live"
+        },
+        {
+          "key": "notification.native",
+          "label": "Native terminal notification",
+          "description": "Send OSC 777/OSC 99 terminal notifications, or Windows toast in Windows Terminal/WSL.",
+          "type": "boolean",
+          "default": true,
+          "category": "Notifications Channels",
+          "apply": "live"
+        },
+        {
+          "key": "notification.tmux",
+          "label": "tmux display-message",
+          "description": "When running inside tmux, also show a transient tmux status-line message. Disabled by default because tmux displays it on the active client, not necessarily as a source-window mark.",
+          "type": "boolean",
+          "default": false,
+          "category": "Notifications Channels",
+          "apply": "live"
+        },
+        {
+          "key": "notification.tmuxWindowMark",
+          "label": "Mark tmux window",
+          "description": "Optionally prefix the source tmux window name when notifying. Disabled by default because BEL should let tmux apply your normal bell styling.",
+          "type": "boolean",
+          "default": false,
+          "category": "Notifications Channels",
+          "apply": "live"
+        },
+        {
+          "key": "notification.tmuxWindowMarkText",
+          "label": "tmux window mark text",
+          "description": "Prefix used when marking the source tmux window.",
+          "type": "string",
+          "default": "!",
+          "category": "Notifications Tuning",
+          "apply": "live"
+        },
+        {
+          "key": "notification.tmuxWindowMarkDurationMs",
+          "label": "tmux window mark duration",
+          "description": "Milliseconds before automatically clearing the tmux window mark. 0 keeps it until next input/agent start/reset.",
+          "type": "number",
+          "default": 0,
+          "category": "Notifications Tuning",
+          "apply": "live"
+        },
+        {
+          "key": "notification.tmuxNativeClientTty",
+          "label": "tmux native via client TTY",
+          "description": "When inside tmux, send OSC terminal notifications directly to attached tmux client TTYs so Ghostty/system notifications still appear for inactive source windows.",
+          "type": "boolean",
+          "default": true,
+          "category": "Notifications Channels",
+          "apply": "live"
+        },
+        {
+          "key": "notification.tmuxPassthrough",
+          "label": "tmux OSC passthrough",
+          "description": "Wrap OSC terminal notifications in tmux passthrough sequences so supported terminals outside tmux can receive them.",
+          "type": "boolean",
+          "default": true,
+          "category": "Notifications Channels",
+          "apply": "live"
+        },
+        {
+          "key": "notification.piUi",
+          "label": "Also show Pi UI notice",
+          "description": "Also call ctx.ui.notify for QOL external notifications. Disabled by default to avoid duplicate in-session noise.",
+          "type": "boolean",
+          "default": false,
+          "category": "Notifications Channels",
+          "apply": "live"
+        },
+        {
+          "key": "notification.oscProtocol",
+          "label": "Terminal notification protocol",
+          "description": "OSC notification protocol. auto uses Kitty OSC 99 when KITTY_WINDOW_ID is present, otherwise OSC 777.",
+          "type": "enum",
+          "enumValues": [
+            "auto",
+            "osc777",
+            "osc99",
+            "off"
+          ],
+          "default": "auto",
+          "category": "Notifications Channels",
+          "apply": "live"
+        },
+        {
+          "key": "notification.cooldownSeconds",
+          "label": "Notification cooldown",
+          "description": "Minimum seconds between duplicate notifications of the same kind.",
+          "type": "number",
+          "default": 8,
+          "category": "Notifications Tuning",
+          "apply": "live"
+        },
+        {
+          "key": "notification.title",
+          "label": "Notification title",
+          "description": "Title used for external terminal notifications.",
+          "type": "string",
+          "default": "Pi",
+          "category": "Notifications Tuning",
+          "apply": "live"
+        },
+        {
+          "key": "notification.readyMessage",
+          "label": "Ready message",
+          "description": "Body text for normal agent-done notifications.",
+          "type": "string",
+          "default": "Ready for input",
+          "category": "Notifications Tuning",
+          "apply": "live"
+        },
+        {
+          "key": "notification.bodyMaxChars",
+          "label": "Notification body length",
+          "description": "Maximum body characters for external notifications.",
+          "type": "number",
+          "default": 240,
+          "category": "Notifications Tuning",
+          "apply": "live"
+        },
+        {
+          "key": "notification.tmuxMessageDurationMs",
+          "label": "tmux message duration",
+          "description": "Milliseconds to display tmux status-line notification messages.",
+          "type": "number",
+          "default": 5000,
+          "category": "Notifications Tuning",
+          "apply": "live"
+        },
+        {
+          "key": "compaction.customEnabled",
+          "label": "Custom compaction summaries",
+          "description": "Use QOL's custom compaction hook instead of Pi's default summary generation. Manual/auto compaction still uses Pi's normal trigger settings.",
+          "type": "boolean",
+          "default": false,
+          "category": "Compaction",
+          "apply": "live"
+        },
+        {
+          "key": "compaction.model",
+          "label": "Compaction model",
+          "description": "Summarizer model as provider/model, a bare model id, or current. Default mirrors Pi's custom-compaction example.",
+          "type": "string",
+          "default": "google/gemini-2.5-flash",
+          "category": "Compaction",
+          "apply": "live"
+        },
+        {
+          "key": "compaction.profile",
+          "label": "Compaction detail profile",
+          "description": "Summary detail level for custom compaction and branch summaries.",
+          "type": "enum",
+          "enumValues": [
+            "concise",
+            "balanced",
+            "exhaustive"
+          ],
+          "default": "balanced",
+          "category": "Compaction",
+          "apply": "live"
+        },
+        {
+          "key": "compaction.maxTokens",
+          "label": "Compaction max output tokens",
+          "description": "Maximum tokens requested from the custom compaction summarizer.",
+          "type": "number",
+          "default": 8192,
+          "category": "Compaction",
+          "apply": "live"
+        },
+        {
+          "key": "compaction.includePreviousSummary",
+          "label": "Include previous summary",
+          "description": "Pass the previous compaction summary to the custom summarizer for iterative continuity.",
+          "type": "boolean",
+          "default": true,
+          "category": "Compaction",
+          "apply": "live"
+        },
+        {
+          "key": "compaction.fallbackToDefault",
+          "label": "Fallback to Pi default compaction",
+          "description": "If custom compaction fails, let Pi run its default compaction instead of cancelling the compaction.",
+          "type": "boolean",
+          "default": true,
+          "category": "Compaction",
+          "apply": "live"
+        },
+        {
+          "key": "compaction.notify",
+          "label": "Show compaction notifications",
+          "description": "Show QOL notifications when custom, remote, branch, or idle compaction starts/fails/completes.",
+          "type": "boolean",
+          "default": true,
+          "category": "Compaction",
+          "apply": "live"
+        },
+        {
+          "key": "compaction.remoteEnabled",
+          "label": "Remote compaction endpoint",
+          "description": "Use a remote HTTP summarization endpoint before falling back to the configured model. Endpoint receives { systemPrompt, prompt, maxTokens } and returns { summary }.",
+          "type": "boolean",
+          "default": false,
+          "category": "Compaction Remote",
+          "apply": "live"
+        },
+        {
+          "key": "compaction.remoteEndpoint",
+          "label": "Remote endpoint URL",
+          "description": "HTTP endpoint for remote compaction summaries. Leave empty to use the configured compaction model.",
+          "type": "string",
+          "default": "",
+          "category": "Compaction Remote",
+          "apply": "live"
+        },
+        {
+          "key": "compaction.branchSummaryEnabled",
+          "label": "Custom branch summaries",
+          "description": "When /tree navigation requests a branch summary, generate it through QOL's custom summarizer.",
+          "type": "boolean",
+          "default": false,
+          "category": "Compaction Branching",
+          "apply": "live"
+        },
+        {
+          "key": "compaction.idleEnabled",
+          "label": "Idle compaction trigger",
+          "description": "Trigger Pi compaction after the session sits idle above the configured token threshold. Inspired by oh-my-pi idle compaction.",
+          "type": "boolean",
+          "default": false,
+          "category": "Compaction Idle",
+          "apply": "live"
+        },
+        {
+          "key": "compaction.idleThresholdTokens",
+          "label": "Idle token threshold",
+          "description": "Token count above which QOL idle compaction can trigger when thresholdTokens and thresholdPercent are unset.",
+          "type": "number",
+          "default": 200000,
+          "category": "Compaction Idle",
+          "apply": "live"
+        },
+        {
+          "key": "compaction.idleTimeoutSeconds",
+          "label": "Idle compaction delay",
+          "description": "Seconds to wait idle before triggering QOL idle compaction.",
+          "type": "number",
+          "default": 300,
+          "category": "Compaction Idle",
+          "apply": "live"
+        },
+        {
+          "key": "compaction.thresholdTokens",
+          "label": "QOL compaction token limit",
+          "description": "Optional fixed token limit for QOL idle compaction. Set -1 to use percentage or idle token threshold.",
+          "type": "number",
+          "default": -1,
+          "category": "Compaction Threshold",
+          "apply": "live"
+        },
+        {
+          "key": "compaction.thresholdPercent",
+          "label": "QOL compaction percent limit",
+          "description": "Optional context-window percentage for QOL idle compaction. Set -1 to use idle token threshold.",
+          "type": "number",
+          "default": -1,
+          "category": "Compaction Threshold",
+          "apply": "live"
+        },
+        {
+          "key": "thinkingLabel.text",
+          "label": "Hidden thinking label",
+          "description": "Label shown when thinking blocks are hidden. Defaults to a Nerd Font brain icon.",
+          "type": "string",
+          "default": " ",
+          "category": "Thinking",
+          "apply": "reload",
+          "requiresReload": true
+        },
+        {
+          "key": "thinkingTimer.enabled",
+          "label": "Show thinking timer",
+          "description": "Show live elapsed time next to collapsed hidden-thinking labels and leave the final duration after thinking ends. Uses a defensive internal renderer patch and fails back to Pi's default label if Pi internals change.",
+          "type": "boolean",
+          "default": true,
+          "category": "Thinking",
+          "apply": "live"
+        }
+      ]
+    }
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-agent-core": "*",
+    "@mariozechner/pi-ai": "*",
+    "@mariozechner/pi-coding-agent": "*",
+    "@mariozechner/pi-tui": "*"
+  },
+  "files": [
+    "extensions/",
+    "assets/",
+    "README.md",
+    "package.json"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vanillagreencom/vstack.git",
+    "directory": "pi-extensions/pi-qol"
+  },
+  "homepage": "https://github.com/vanillagreencom/vstack/tree/main/pi-extensions/pi-qol",
+  "bugs": {
+    "url": "https://github.com/vanillagreencom/vstack/issues"
+  },
+  "author": "vanillagreen",
+  "publishConfig": {
+    "access": "public"
+  }
+}