pi-minimalist 0.1.0 → 0.1.2

package/README.md

@@ -1,24 +1,60 @@
 # pi-minimalist
 
-Make Pi's tool calls and optional thinking previews quieter: compact, one-line rows without losing access to the original tool output.
+**Less scrolling. More room for the answer.**
 
-## What does minimalist mode look like
+A quieter transcript for [Pi](https://pi.dev): turn bulky tool calls into one-line summaries, and open the full output whenever you need it.
 
-Before pi-minimalist:
+## See the difference
 
-<img width="656" height="550" alt="before" src="https://github.com/user-attachments/assets/aa1602f7-5db1-49b8-a4d3-cbd1aef69ea0" />
+**Before:** one tool call takes up most of the screen.
 
+<img width="656" height="550" alt="before" src="https://github.com/user-attachments/assets/aa1602f7-5db1-49b8-a4d3-cbd1aef69ea0" />
 
-After pi-minimalist:
+**After:** the same call, one line.
 
 <img width="699" height="50" alt="after" src="https://github.com/user-attachments/assets/c0e8bca4-afa7-42c1-9bf0-69f267d18d9f" />
 
-## Installation
-Install with npm:
+Press **Ctrl+O** to expand tool output—including diffs and syntax highlighting. Nothing is removed from the session or hidden from the model; only the display changes.
+
+## Install
+
 ```bash
- pi install npm:pi-minimalist
+pi install npm:pi-minimalist
 ```
 
-## Configuration
+Restart Pi, and tool calls appear as compact rows. No configuration needed.
+
+## Choose how quiet you want it
+
+Run **`/minimalist`** to change settings live. Start with compact tool rows, or go further:
+
+- **Combine consecutive tool calls** into a single summary, such as `read ×2, edit ×1`.
+- **Collapse earlier activity** so the latest reply stays in focus. Replace the preceding activity with elapsed work time or tool counts.
+- **Compact thinking rows**, or keep thinking visible as it arrives.
+- **Keep running tools visible** while grouping other calls, with an elapsed timer to show how long they take.
+
+Compact tool rows and consecutive-call grouping are **on by default**. Activity folding and compact thinking are opt-in. Disable grouping if you prefer to see each call separately.
+
+### Everyday controls
+
+| Control | Action |
+| --- | --- |
+| `/minimalist` | Open settings (`/minimalist config` also works) |
+| `/minimalist status` | Show current settings |
+| Ctrl+O | Expand or collapse tool output |
+| Ctrl+T | Expand or collapse thinking |
+| Restore defaults | Reset display settings in the editor |
+
+Settings apply to existing conversation history and are saved globally. If a symbol looks wrong in your terminal, choose **Symbols → ASCII**. No Nerd Font required.
+
+## Go back to Pi's usual view
+
+Turn off **Compact tool rows** to restore native tool cards. Other folding options are independent; **Restore defaults** returns to the extension's initial settings, not native Pi.
+
+To disable the extension completely, run `pi config`, disable pi-minimalist, and restart Pi. To uninstall:
+
+## Compatibility
+
+Tested with Pi **1.0.0**. Pi updates can affect rendering compatibility; [report a problem](https://github.com/EviHex/pi-minimalist/issues) with your Pi version, terminal, and a screenshot.
 
-You may configure different collapse options / verbosity levels with the slash command `/minimalist config`.
+[MIT licensed](LICENSE).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-minimalist",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Compact one-line tool and thinking rows for Pi's interactive transcript",
   "keywords": ["pi-package"],
   "license": "MIT",

package/src/components.ts

@@ -7,7 +7,7 @@
  */
 
 import { truncateToWidth } from "@earendil-works/pi-tui";
-import type { Component } from "@earendil-works/pi-tui";
+import type { Component, TuiMouseEvent, TuiMouseEventResult } from "@earendil-works/pi-tui";
 import { gutterWidth, type Row } from "./row.ts";
 
 /**
@@ -50,6 +50,7 @@ export type ResolveRow = (width: number) => Row | null;
  */
 export class CompactLine implements Component {
   private resolve: ResolveRow = () => null;
+  private click?: () => boolean;
   private ticker: unknown;
   private timers: Timers;
 
@@ -57,9 +58,20 @@ export class CompactLine implements Component {
     this.timers = timers;
   }
 
-  /** Install the row resolver. Called on every updateDisplay with fresh state. */
-  setRow(resolve: ResolveRow): void {
+  /**
+   * Install the row resolver. Called on every updateDisplay with fresh state.
+   * `click` returning true stops Pi's own left-click (expand) handler.
+   */
+  setRow(resolve: ResolveRow, click?: () => boolean): void {
     this.resolve = resolve;
+    this.click = click;
+  }
+
+  // Pi's MouseRegion asks its child first, so a handled click never reaches
+  // the region's own expand/collapse toggle.
+  handleMouse(event: TuiMouseEvent): TuiMouseEventResult | undefined {
+    if (event.type !== "click" || event.button !== "left") return undefined;
+    return this.click?.() ? { handled: true } : undefined;
   }
 
   /**

package/src/config.ts

@@ -128,7 +128,7 @@ export type Settings = BasicSettings & AdvancedSettings;
 
 export const DEFAULT_BASIC: BasicSettings = {
   compactToolRows: true,
-  groupToolRuns: false,
+  groupToolRuns: true,
   foldIntermediateActivity: false,
   foldActivityOnFinalAnswer: false,
   activitySummary: "elapsed",

package/src/run-grouping.ts

@@ -55,6 +55,8 @@ export class RunGrouping {
   private cycle = 0;
   private cycles = new Map<number, Cycle>();
   private agentActive = false;
+  /** Rows the user opened out of a summary by clicking it. Never fold again. */
+  private opened = new Set<string>();
   private version = 0;
   private cache?: ViewCache;
 
@@ -226,6 +228,33 @@ export class RunGrouping {
     return painter.summary(view);
   }
 
+  /**
+   * Open the summary this row draws back into separate rows, after a click.
+   *
+   * Needed because the summary is drawn by ONE member (the tail) and the others
+   * draw zero lines: Pi's own click handler would expand only the tail.
+   * Returns false when the row draws no summary, so Pi's click still applies.
+   */
+  open(id: string): boolean {
+    const entry = this.byId.get(id);
+    if (!entry) return false;
+    const { activity, grouped } = this.views();
+    const members = [entry];
+    if (activity.get(id) === "summary") {
+      members.push(...this.entries.filter((e) => e.cycle === entry.cycle && activity.get(e.id) === "hide"));
+    } else if (typeof grouped.get(id) === "object") {
+      // A run's hidden members are the contiguous "hide" rows before its tail.
+      for (let i = this.entries.indexOf(entry) - 1; i >= 0 && grouped.get(this.entries[i].id) === "hide"; i--) {
+        members.push(this.entries[i]);
+      }
+    } else {
+      return false;
+    }
+    for (const member of members) this.opened.add(member.id);
+    this.invalidateViews();
+    return true;
+  }
+
   view(id: string): RowView {
     return this.views().grouped.get(id) ?? "show";
   }
@@ -320,7 +349,7 @@ export class RunGrouping {
   }
 
   private activityFoldable(entry: Entry): boolean {
-    if (entry.expanded) return false;
+    if (entry.expanded || this.opened.has(entry.id)) return false;
     if (entry.outcome === "pending" && entry.kind !== "prose" && this.config.get("keepActiveToolsExpanded")) {
       return false;
     }
@@ -328,7 +357,7 @@ export class RunGrouping {
   }
 
   private foldable(entry: Entry | undefined): boolean {
-    if (!entry?.foldable || entry.expanded) return false;
+    if (!entry?.foldable || entry.expanded || this.opened.has(entry.id)) return false;
     if (entry.kind === "thinking" && !this.config.get("thinkingAsToolCall")) return false;
     if (entry.outcome === "pending" && this.config.get("keepActiveToolsExpanded")) return false;
     return true;

package/src/thinking.ts

@@ -59,7 +59,7 @@ export function createThinkingPreview(deps: ThinkingDeps): ThinkingPreview {
 
     if (owner && runIndex !== undefined) {
       const id = grouping.thinkingId(owner, runIndex);
-      line.setRow(() => grouping.rowFor(id, new Painter(theme, config), paint));
+      line.setRow(() => grouping.rowFor(id, new Painter(theme, config), paint), () => grouping.open(id));
     } else {
       line.setRow(paint);
     }

package/src/tool-renderer.ts

@@ -194,7 +194,10 @@ export function createToolRenderer(deps: RendererDeps): ToolRenderer {
         return component;
       }
       grouping.observe(id, summaryName(name, args), status.outcome, context.expanded === true);
-      component.setRow((width) => grouping.rowFor(id, new Painter(theme, config), () => paint(width)));
+      component.setRow(
+        (width) => grouping.rowFor(id, new Painter(theme, config), () => paint(width)),
+        () => grouping.open(id),
+      );
       return component;
     },