pi-minimal 0.1.0

package/doc/plans/2026-09-22-pi-minimal-package.md

@@ -0,0 +1,354 @@
+# pi-minimal Package Implementation Plan
+
+> **REQUIRED SUB-SKILL:** Use the subagent-driven-development skill to implement this plan task-by-task.
+
+**Goal:** Package the current Grok-style Pi interface as an installable `pi-minimal` extension without changing its visual behavior except thinking-block visibility.
+
+**Architecture:** Session-path TypeScript lives in `src/`, emits committed JavaScript to `dist/`, and loads layered JSON configuration before installing chrome. Tests compile separately and exercise configuration, tracker visibility, and session wiring without touching the live Pi setup.
+
+**Tech Stack:** TypeScript, Node.js 22.19.0+, Node test runner, Pi extension APIs.
+
+**Spec:** `doc/specs/2026-09-22-pi-minimal-package.md`
+
+**Verification:** `npm test && npm run build && git diff --exit-code -- dist && PI_CODING_AGENT_DIR="$(mktemp -d)" pi --no-extensions -e ./dist/index.js --version`
+
+---
+
+## Files
+
+**Create:**
+- `package.json`
+- `package-lock.json`
+- `tsconfig.json`
+- `tsconfig.tests.json`
+- `.gitignore`
+- `LICENSE`
+- `README.md`
+- `src/activity.ts`
+- `src/chrome.ts`
+- `src/config.ts`
+- `src/cwd.ts`
+- `src/footer.ts`
+- `src/header.ts`
+- `src/herdr.ts`
+- `src/index.ts`
+- `src/live-watch.ts`
+- `src/reclaim.ts`
+- `src/tool-rows.ts`
+- `src/tools.ts`
+- `src/tracker.ts`
+- `src/working-status.ts`
+- `test/activity.test.ts`
+- `test/config.test.ts`
+- `test/index.test.ts`
+- `test/tracker.test.ts`
+- `dist/` generated extension output
+
+**Modify:** none
+
+**Delete:** none
+
+## Wave 1 — Foundations
+
+Parallel-safe: Tasks 1–4 own disjoint files.
+
+### Task 1: Package metadata
+
+**TDD scenario:** New feature — full TDD cycle
+
+**Spec:** doc/specs/2026-09-22-pi-minimal-package.md § "Package contract" L19-L35
+
+**Files:**
+- Create: `package.json`
+- Create: `tsconfig.json`
+- Create: `tsconfig.tests.json`
+- Create: `.gitignore`
+- Create: `package-lock.json`
+
+- [ ] **Step 1: Write the failing package test**
+
+```js
+import assert from "node:assert/strict"
+import test from "node:test"
+import { readFileSync } from "node:fs"
+
+test("package manifest exposes the committed extension", () => {
+  const pkg = JSON.parse(readFileSync("package.json", "utf8"))
+  assert.equal(pkg.name, "pi-minimal")
+  assert.equal(pkg.version, "0.1.0")
+  assert.equal(pkg.license, "MIT")
+  assert.equal(pkg.type, "module")
+  assert.deepEqual(pkg.engines, { node: ">=22.19.0" })
+  assert.deepEqual(pkg.keywords, ["pi-package"])
+  assert.deepEqual(pkg.pi, { extensions: ["./dist/index.js"] })
+  assert.deepEqual(pkg.peerDependencies, {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+  })
+})
+```
+
+- [ ] **Step 2: Run test, confirm failure**
+
+Run: `node --test test/package.test.js`
+Expected: FAIL because `package.json` does not exist.
+
+- [ ] **Step 3: Add the package files**
+
+Create `package.json` with the asserted fields, `"private": false`, devDependencies `typescript`, `@types/node`, `@earendil-works/pi-coding-agent`, and `@earendil-works/pi-tui`, and scripts `"build": "tsc -p tsconfig.json"` and `"test": "tsc -p tsconfig.tests.json && node --test test-dist/*.test.js"`.
+
+Create `tsconfig.json` with `rootDir: src`, `outDir: dist`, `module: NodeNext`, `moduleResolution: NodeNext`, `target: ES2022`, `strict: true`, and `include: ["src"]`.
+
+Create `tsconfig.tests.json` extending it with `rootDir: .`, `outDir: test-dist`, and `include: ["src", "test"]`.
+
+Create `.gitignore` containing `node_modules/` and `test-dist/`, but not `dist/`.
+
+- [ ] **Step 4: Run test, confirm pass**
+
+Run: `npm install && node --test test/package.test.js`
+Expected: PASS
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add package.json package-lock.json tsconfig.json tsconfig.tests.json .gitignore test/package.test.js
+git commit -m "Add pi-minimal package manifest"
+```
+
+### Task 2: Configuration loader
+
+**TDD scenario:** New feature — full TDD cycle
+
+**Spec:** doc/specs/2026-09-22-pi-minimal-package.md § "Configuration" L47-L64
+
+**Files:**
+- Create: `src/config.ts`
+- Test: `test/config.test.ts`
+
+- [ ] **Step 1: Write the failing config tests**
+
+Test `loadPiMinimalConfig({ agentDir, cwd, projectTrusted })` with temporary directories. Assert default `{ hideGauntletWidgets: true }`; global false overrides default; trusted project true overrides global false; untrusted project false does not override global true; omitted keys and unknown keys do not override; invalid JSON, a non-object root, and non-boolean `hideGauntletWidgets` call `console.error` and leave the lower-precedence value unchanged.
+
+- [ ] **Step 2: Run test, confirm failure**
+
+Run: `npx tsc -p tsconfig.tests.json && node --test test-dist/test/config.test.js`
+Expected: FAIL because `src/config.ts` does not exist.
+
+- [ ] **Step 3: Implement the loader**
+
+Export `PiMinimalConfig` and `loadPiMinimalConfig`. Read `join(agentDir, "pi-minimal.json")`, then `join(cwd, CONFIG_DIR_NAME, "pi-minimal.json")` only when `projectTrusted` is true. Parse with `JSON.parse`, validate only `hideGauntletWidgets`, and use `console.error` for invalid layers.
+
+- [ ] **Step 4: Run test, confirm pass**
+
+Run: `npx tsc -p tsconfig.tests.json && node --test test-dist/test/config.test.js`
+Expected: PASS
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/config.ts test/config.test.ts
+git commit -m "Add layered pi-minimal configuration"
+```
+
+### Task 3: Tracker visibility
+
+**TDD scenario:** New feature — full TDD cycle
+
+**Spec:** doc/specs/2026-09-22-pi-minimal-package.md § "Runtime behavior" L37-L45
+
+**Files:**
+- Create: `src/tracker.ts`
+- Test: `test/tracker.test.ts`
+
+- [ ] **Step 1: Write the failing tracker tests**
+
+Assert a phase line appears only when one phase is not `pending`, an empty or all-pending snapshot emits no phase line, a nonempty task list emits a task line, and an empty task list emits none. Assert `hideGauntletWidgets` calls `setWidget("phase_tracker", undefined)` and `setWidget("plan_tracker", undefined)`.
+
+- [ ] **Step 2: Run test, confirm failure**
+
+Run: `npx tsc -p tsconfig.tests.json && node --test test-dist/test/tracker.test.js`
+Expected: FAIL because `src/tracker.ts` does not exist.
+
+- [ ] **Step 3: Copy and preserve the tracker**
+
+Copy `formatTrackerLines` and `hideGauntletWidgets` from the live extension without changing their visibility rules.
+
+- [ ] **Step 4: Run test, confirm pass**
+
+Run: `npx tsc -p tsconfig.tests.json && node --test test-dist/test/tracker.test.js`
+Expected: PASS
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/tracker.ts test/tracker.test.ts
+git commit -m "Preserve tracker footer visibility"
+```
+
+### Task 4: Activity rendering
+
+**TDD scenario:** New feature — full TDD cycle
+
+**Spec:** doc/specs/2026-09-22-pi-minimal-package.md § "Source and compatibility decisions" L66-L72
+
+**Files:**
+- Create: `src/activity.ts`
+- Test: `test/activity.test.ts`
+
+- [ ] **Step 1: Write the failing activity tests**
+
+Assert `rowIsRunning` is false when `isPartial` is false and true when it is true. Assert `activityBullet(false, 0)`, `activityBullet(false, 1)`, and `activityBullet(true, 0)` return `"◆"`, while `activityBullet(true, 1)` returns `"◇"`.
+
+- [ ] **Step 2: Run test, confirm failure**
+
+Run: `npx tsc -p tsconfig.tests.json && node --test test-dist/test/activity.test.js`
+Expected: FAIL because `src/activity.ts` does not exist.
+
+- [ ] **Step 3: Copy the activity helpers**
+
+Copy `ActivityContext`, `rowIsRunning`, and `activityBullet` unchanged. Do not add `paintActivityLines`.
+
+- [ ] **Step 4: Run test, confirm pass**
+
+Run: `npx tsc -p tsconfig.tests.json && node --test test-dist/test/activity.test.js`
+Expected: PASS
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src/activity.ts test/activity.test.ts
+git commit -m "Preserve activity rendering helpers"
+```
+
+## Wave 2 — Session wiring
+
+Solo: Task 5 imports the configuration, tracker, and activity modules created in Wave 1.
+
+Depends on Wave 1: Task 5 consumes those modules.
+
+### Task 5: Extension session wiring
+
+**TDD scenario:** New feature — full TDD cycle
+
+**Spec:** doc/specs/2026-09-22-pi-minimal-package.md § "Runtime behavior" L37-L45, § "Verification" L74-L86
+
+**Files:**
+- Create: `src/index.ts`
+- Create: `src/header.ts`
+- Create: `src/footer.ts`
+- Create: `src/cwd.ts`
+- Create: `src/chrome.ts`
+- Create: `src/herdr.ts`
+- Create: `src/tools.ts`
+- Create: `src/tool-rows.ts`
+- Create: `src/working-status.ts`
+- Create: `src/reclaim.ts`
+- Create: `src/live-watch.ts`
+- Test: `test/index.test.ts`
+
+- [ ] **Step 1: Write the failing session tests**
+
+Drive the default export with a fake `ExtensionAPI`, emit `session_start`, and assert `setHiddenThinkingLabel("◆ Thought")`, no-argument `setWorkingIndicator()`, header, footer, and `tw-cwd` installation. Assert both Gauntlet widgets are cleared by default and neither is cleared when config disables hiding. Assert `setHideThinkingBlock` is absent from all calls. Assert no `herdr` execution when `HERDR_ENV` is unset and one probe when it equals `"1"`.
+
+- [ ] **Step 2: Run test, confirm failure**
+
+Run: `npx tsc -p tsconfig.tests.json && node --test test-dist/test/index.test.js`
+Expected: FAIL because `src/index.ts` does not exist.
+
+- [ ] **Step 3: Copy the session path and apply the deltas**
+
+Copy the live session-path modules. Replace `editor.ts` with `src/chrome.ts` exporting `CHROME_MARGIN = 1`, and update imports to `./chrome.js`. Remove the `SettingsManager` import and `setHideThinkingBlock` call. Load config from `getAgentDir()` and `ctx.isProjectTrusted()` before the first reclaim, and skip widget clearing when `hideGauntletWidgets` is false.
+
+- [ ] **Step 4: Run test, confirm pass**
+
+Run: `npx tsc -p tsconfig.tests.json && node --test test-dist/test/index.test.js`
+Expected: PASS
+
+- [ ] **Step 5: Commit**
+
+```bash
+git add src test/index.test.ts
+git commit -m "Wire the pi-minimal session chrome"
+```
+
+## Wave 3 — Release artifact
+
+Solo: Task 6 builds the extension entry created in Wave 2.
+
+Depends on Wave 2: Task 6 emits `dist/index.js` from `src/index.ts`.
+
+### Task 6: Build and installation smoke
+
+**TDD scenario:** Trivial change — use judgment
+
+**Spec:** doc/specs/2026-09-22-pi-minimal-package.md § "Verification" L74-L86
+
+**Files:**
+- Create: `dist/index.js`
+- Create: `dist/` supporting emitted modules
+
+- [ ] **Step 1: Build the extension**
+
+Run: `npm test && npm run build`
+Expected: tests pass and `dist/index.js` exists.
+
+- [ ] **Step 2: Confirm the artifact is stable**
+
+Run: `git diff --exit-code -- dist`
+Expected: exit 0 after `dist/` is committed.
+
+- [ ] **Step 3: Load it in an isolated Pi directory**
+
+Run: `PI_CODING_AGENT_DIR="$(mktemp -d)" pi --no-extensions -e ./dist/index.js --version`
+Expected: Pi starts with the extension and exits successfully without reading or writing the live agent directory.
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add dist
+git commit -m "Add committed pi-minimal build"
+```
+
+## Wave 4 — Documentation
+
+Solo: lone remaining task.
+
+Depends on Waves 1–3: the README documents the completed package contract and artifact.
+
+### Task 7: README and license
+
+**TDD scenario:** Trivial change — use judgment
+
+**Spec:** doc/specs/2026-09-22-pi-minimal-package.md § "Documentation impact" L88-L91
+
+**Files:**
+- Create: `README.md`
+- Create: `LICENSE`
+
+- [ ] **Step 1: Add the MIT license**
+
+Use the standard MIT license with `Copyright (c) 2026 raviy06`.
+
+- [ ] **Step 2: Document installation and configuration**
+
+Document Node.js `>=22.19.0`, Pi `>=0.84.4`, `pi install git:github.com/raviy06/pi-minimal`, `hideGauntletWidgets`, and the warning not to load this package beside the live `grok-chrome` extension.
+
+- [ ] **Step 3: Commit**
+
+```bash
+git add README.md LICENSE
+git commit -m "Document pi-minimal installation"
+```
+
+## Spec coverage
+
+| anchor | requirement (short) | owner |
+|---|---|---|
+| § "Package contract" L19-L35 | publish the Pi package manifest and peers | Task 1 |
+| § "Runtime behavior" L37-L45 | preserve chrome and gate widget hiding | Task 5 |
+| § "Runtime behavior" L37-L45 | preserve tracker line visibility | Task 3 |
+| § "Configuration" L47-L64 | layer and validate configuration | Task 2 |
+| § "Source and compatibility decisions" L66-L72 | build NodeNext output and test activity helpers | Task 4, Task 6 |
+| § "Verification" L74-L86 | isolate tests and installation smoke | Task 5, Task 6 |
+| § "Documentation impact" L88-L91 | add README and license | Task 7 |
+| § "Out of scope" L93-L99 | exclude publishing, cutover, and unrelated migrations | waived: out of scope per spec |

package/doc/specs/2026-09-22-pi-minimal-package.md

@@ -0,0 +1,94 @@
+# pi-minimal Package
+
+## Goal
+
+Package the current Grok-style Pi interface as the public Pi package `pi-minimal`, so another machine can install it with Pi's normal package installer while retaining the current visual behavior, except thinking-block visibility. The package never reads or writes `hideThinkingBlock`; that display follows the user's existing Pi setting. `setHiddenThinkingLabel` restyles a hidden label and does not hide thinking blocks.
+
+## Scope
+
+`pi-minimal` version `0.1.0` includes:
+
+- The current header, footer, cwd widget, compact built-in tool rendering, working-status display, and optional Herdr integration.
+- Compact phase and task lines in the package footer when current tracker rules make them visible.
+- A TypeScript build targeting Node.js 22.19.0 or newer and Pi 0.84.4 or newer.
+- Package metadata, MIT license, README, and automated tests.
+
+The package does not include Omarchy themes, Omarchy skills, credentials, sessions, agentmemory, MCP configuration, or other local Pi customizations.
+
+The live extension at `~/.pi/agent/extensions/grok-chrome` remains untouched during implementation and verification. Cutover is a separate user action after the packaged extension is verified.
+
+## Package contract
+
+The repository root contains `package.json` with:
+
+- `"name": "pi-minimal"`
+- `"version": "0.1.0"`
+- `"license": "MIT"`
+- `"type": "module"`
+- `"engines": { "node": ">=22.19.0" }`
+- `"keywords": ["pi-package"]`
+- `"pi": { "extensions": ["./dist/index.js"] }`
+- `peerDependencies` of `"*"` for `@earendil-works/pi-coding-agent` and `@earendil-works/pi-tui`
+
+`typescript` and `@types/node` are development dependencies. The Pi packages remain wildcard peers and are not bundled. `npm run build` refreshes the committed `dist/` artifact. `dist/` is not gitignored, so a normal Git installation receives `dist/index.js` without a consumer build or npm publication.
+
+The MIT license uses `Copyright (c) 2026 raviy06`. The README documents `pi install git:github.com/raviy06/pi-minimal`, the Node and Pi requirements, configuration, and the cutover warning.
+
+## Runtime behavior
+
+On TUI `session_start`, before the first reclaim, the extension loads configuration and installs the current visual chrome and compact renderers. It calls `ctx.ui.setHiddenThinkingLabel("◆ Thought")` and no-argument `ctx.ui.setWorkingIndicator()`. It never reads or writes Pi's `hideThinkingBlock` setting.
+
+Gauntlet widget hiding is enabled unless configuration explicitly disables it. When enabled, the extension clears the `phase_tracker` and `plan_tracker` widgets and continues reclaiming that space. When disabled, it does not clear or reclaim those widgets. Footer visibility follows the current tracker rules regardless of that setting: the phase line appears only when at least one phase is not `pending`, and the task line appears only when the task list is nonempty.
+
+Herdr probing and sibling display occur only when `HERDR_ENV=1`, as they do now. Print, JSON, and RPC modes do not install TUI components.
+
+## Configuration
+
+The extension loads configuration in this order:
+
+1. Built-in defaults.
+2. `join(getAgentDir(), "pi-minimal.json")`, when present. This is `~/.pi/agent/pi-minimal.json` unless Pi's agent directory is overridden.
+3. `join(ctx.cwd, CONFIG_DIR_NAME, "pi-minimal.json")`, only when `ctx.isProjectTrusted()` returns true.
+
+Project values override global values. A missing file, omitted `hideGauntletWidgets` key, or invalid value does not override the lower-precedence value. Invalid JSON, a non-object root, or a non-boolean `hideGauntletWidgets` value produces a `console.error` warning and is ignored at that layer. Unknown keys are ignored.
+
+The only supported key is:
+
+```json
+{ "hideGauntletWidgets": false }
+```
+
+Its default is `true`. A non-boolean value is invalid for that key, produces a warning, and leaves the lower-precedence value unchanged.
+
+## Source and compatibility decisions
+
+Session-path sources live in `src/` and emit to `dist/`. The implementation copies the current modules needed by the live session path and excludes unused modules. TypeScript uses `NodeNext` module settings, and tests are excluded from the extension entry. Relative `.js` import specifiers are preserved. Runtime and tests do not require Node's TypeScript strip-types flag.
+
+The activity test asserts the exported `activityBullet` and `rowIsRunning` behavior. `paintActivityLines` is not added.
+
+## Verification
+
+Verification uses temporary directories only. It sets `PI_CODING_AGENT_DIR` and must not modify the user's live Pi configuration, authentication, sessions, or `grok-chrome` directory. Any Pi process also uses `--no-extensions -e ./dist/index.js` so the live extension cannot load.
+
+`npm test` builds the tests and runs `node --test` against emitted `.js` specifiers. It covers default widget hiding, the `false` opt-out, trusted project override, untrusted project skip, omitted keys, invalid JSON, active and empty tracker fixtures, named chrome calls, `HERDR_ENV` gating, and a spy proving `setHideThinkingBlock` is never called.
+
+The required release checks are:
+
+- `npm test` and `npm run build` pass on Node.js 22.19.0 using emitted JavaScript.
+- `dist/index.js` is committed and matches the build output.
+- A clean checkout loads through `pi install` without a consumer build.
+- The installed extension loads under Pi 0.84.4 or newer.
+
+## Documentation impact
+
+- Feature / user-facing docs introduced: README.md — operations and package configuration
+- Materially amended existing docs: none
+- Derived / memory docs invalidated: none
+
+## Out of scope
+
+- npm registry publication
+- Git tag or GitHub release creation
+- automatic removal or disabling of the live extension
+- migration of unrelated Pi settings and extensions
+- changes to Pi core or Gauntlet

package/eslint.config.js

@@ -0,0 +1,8 @@
+import js from "@eslint/js"
+import tseslint from "typescript-eslint"
+
+export default tseslint.config(
+  { ignores: ["dist/**", "test-dist/**", "node_modules/**"] },
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+)

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "pi-minimal",
+  "version": "0.1.0",
+  "license": "MIT",
+  "type": "module",
+  "private": false,
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "keywords": [
+    "pi-package"
+  ],
+  "pi": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "@eslint/js": "^10.0.1",
+    "@types/node": "*",
+    "eslint": "^10.11.0",
+    "typescript": "*",
+    "typescript-eslint": "^8.70.1"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "tsc -p tsconfig.tests.json && node --test test-dist/test/*.test.js",
+    "lint": "eslint .",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/src/activity.ts

@@ -0,0 +1,16 @@
+export type ActivityContext = {
+  isPartial?: boolean
+  isError?: boolean
+  state?: { done?: boolean; running?: boolean }
+}
+
+export function rowIsRunning(context: ActivityContext): boolean {
+  if (context.isError) return false
+  if (context.state?.done) return false
+  if (context.isPartial === false) return false
+  return true
+}
+
+export function activityBullet(running: boolean, frame: 0 | 1): "◆" | "◇" {
+  return running && frame === 1 ? "◇" : "◆"
+}

package/src/chrome.ts

@@ -0,0 +1 @@
+export const CHROME_MARGIN = 1

package/src/config.ts

@@ -0,0 +1,59 @@
+import { readFileSync } from "node:fs"
+import { join } from "node:path"
+import { CONFIG_DIR_NAME } from "@earendil-works/pi-coding-agent"
+
+export type PiMinimalConfig = {
+	hideGauntletWidgets: boolean
+}
+
+const DEFAULTS: PiMinimalConfig = {
+	hideGauntletWidgets: true,
+}
+
+export function loadPiMinimalConfig(options: {
+	agentDir: string
+	cwd: string
+	projectTrusted: boolean
+}): PiMinimalConfig {
+	const config: PiMinimalConfig = { ...DEFAULTS }
+	applyLayer(config, join(options.agentDir, "pi-minimal.json"))
+	if (options.projectTrusted) {
+		applyLayer(config, join(options.cwd, CONFIG_DIR_NAME, "pi-minimal.json"))
+	}
+	return config
+}
+
+function applyLayer(config: PiMinimalConfig, path: string): void {
+	let text: string
+	try {
+		text = readFileSync(path, "utf8")
+	} catch {
+		return
+	}
+
+	let parsed: unknown
+	try {
+		parsed = JSON.parse(text)
+	} catch {
+		console.error(`pi-minimal: invalid JSON in ${path}`)
+		return
+	}
+
+	if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+		console.error(`pi-minimal: expected an object in ${path}`)
+		return
+	}
+
+	const record = parsed as Record<string, unknown>
+	if (!Object.hasOwn(record, "hideGauntletWidgets")) {
+		return
+	}
+
+	const value = record.hideGauntletWidgets
+	if (typeof value !== "boolean") {
+		console.error(`pi-minimal: hideGauntletWidgets must be a boolean in ${path}`)
+		return
+	}
+
+	config.hideGauntletWidgets = value
+}

package/src/cwd.ts

@@ -0,0 +1,108 @@
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui"
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent"
+import path from "node:path"
+import { CHROME_MARGIN } from "./chrome.js"
+
+function formatCwd(cwd: string): string {
+  const home = process.env.HOME || process.env.USERPROFILE || ""
+  if (!home) return cwd
+  const resolved = path.resolve(cwd)
+  const rel = path.relative(path.resolve(home), resolved)
+  if (!rel.startsWith("..") && !path.isAbsolute(rel)) {
+    return rel ? `~/${rel}` : "~"
+  }
+  return cwd
+}
+
+function formatTokens(n: number): string {
+  if (n < 1000) return String(n)
+  if (n < 10000) return `${(n / 1000).toFixed(1)}K`
+  if (n < 1e6) return `${Math.round(n / 1000)}K`
+  if (n < 1e7) return `${(n / 1e6).toFixed(1)}M`
+  return `${Math.round(n / 1e6)}M`
+}
+
+function modelIcon(id: string): string {
+  const s = id.toLowerCase()
+  if (s.includes("grok")) return "✦"
+  if (
+    s.includes("claude") ||
+    s.includes("fable") ||
+    s.includes("sonnet") ||
+    s.includes("opus") ||
+    s.includes("haiku")
+  ) {
+    return "✳"
+  }
+  if (s.includes("gpt") || s.includes("codex")) return "◈"
+  return "◆"
+}
+
+function shortModel(id: string): string {
+  return (id.split("/").pop() || id).replace(/^claude-/, "")
+}
+
+function thinkingColor(level: string): "dim" | "accent" | "warning" {
+  if (level === "high" || level === "xhigh" || level === "max") return "warning"
+  if (level === "medium") return "accent"
+  return "dim"
+}
+
+function meter(percent: number, fill: string, empty: string): string {
+  const n = 8
+  const filled = Math.max(0, Math.min(n, Math.round((percent / 100) * n)))
+  return fill.repeat(filled) + empty.repeat(n - filled)
+}
+
+function splitRow(left: string, right: string, width: number): string {
+  let L = left
+  let R = right
+  while (visibleWidth(L) + 1 + visibleWidth(R) > width && visibleWidth(R) > 0) {
+    R = truncateToWidth(R, Math.max(0, visibleWidth(R) - 1), "")
+  }
+  while (visibleWidth(L) + 1 + visibleWidth(R) > width && visibleWidth(L) > 0) {
+    L = truncateToWidth(L, Math.max(0, visibleWidth(L) - 1), "")
+  }
+  const gap = Math.max(1, width - visibleWidth(L) - visibleWidth(R))
+  return L + " ".repeat(gap) + R
+}
+
+export function installCwd(ctx: ExtensionContext): void {
+  ctx.ui.setWidget(
+    "tw-cwd",
+    (_tui, theme) => ({
+      invalidate() {},
+      render(width: number): string[] {
+        const inner = Math.max(8, width - CHROME_MARGIN * 2)
+        const id = ctx.model?.id || "no-model"
+        const icon = theme.fg("accent", modelIcon(id))
+        const name = theme.fg("text", shortModel(id))
+        const usage = ctx.getContextUsage?.()
+        const window = usage?.contextWindow || ctx.model?.contextWindow
+        const used = usage?.tokens
+        let tokenStr = theme.fg("dim", "?/?")
+        let bar = theme.fg("dim", "░░░░░░░░")
+        let pctStr = theme.fg("dim", "?%")
+        if (typeof used === "number" && window) {
+          const pct = Math.max(0, Math.min(100, Math.round((used / window) * 100)))
+          tokenStr = theme.fg("dim", `${formatTokens(used)}/${formatTokens(window)}`)
+          const hot = pct >= 85
+          bar = meter(pct, theme.fg(hot ? "warning" : "accent", "█"), theme.fg("dim", "░"))
+          pctStr = theme.fg(hot ? "warning" : "muted", `${pct}%`)
+        } else if (used === null && window) {
+          tokenStr = theme.fg("dim", `?/${formatTokens(window)}`)
+        }
+        const thinking = ctx.thinkingLevel || ""
+        const think = thinking ? theme.fg(thinkingColor(thinking), thinking) : ""
+        const midot = theme.fg("dim", " · ")
+        const left = [`${icon} ${name}`, tokenStr, `${bar} ${pctStr}`, think]
+          .filter(Boolean)
+          .join(midot)
+        const right = ctx.cwd ? theme.fg("accent", formatCwd(ctx.cwd)) : ""
+        const row = splitRow(left, right, inner)
+        return [`${" ".repeat(CHROME_MARGIN)}${row}`]
+      },
+    }),
+    { placement: "aboveEditor" },
+  )
+}