picc-working-spinner

Claude Code style spinner · ✢ ✳ ✶ ✻ ✽ for pi: spinner glyph, shimmer sweep, mode-aware status line, stall detection, thinking glow, smooth token counter. Part of picc, a pi agent setup mirroring Claude Code's harness.

Fork of npm:pi-claude-shimmer, better aligned with the actual Claude Code spinner implementation.

Usage

Install via pi install npm:@ladbabynpm/picc-working-spinner.

Changes vs. upstream

• agent_end previously reported the final turn's duration instead of total run time. Date.now() - (agentStart || turnStart) is now used in the completion message, matching the live status calculation.
• Re-derived each animation parameter from the actual claude-code source.

| Area | Before | After | | --- | --- | --- | | Spinner glyphs | macOS-only: · ✢ ✳ ✶ ✻ ✽ | Platform-aware: macOS / Linux / Windows / Ghostty variants (verbatim from components/Spinner/utils.ts) | | Verb list | 40 verbs (curated) | 186 verbs (verbatim from constants/spinnerVerbs.ts) | | Stall ramp | Frame-based: 30 frames at 200ms = 6s | Time-based: 3s start + 2s ramp to full red, 50ms tick with += diff * 0.1 smoothing (matches useStalledAnimation.ts) | | Thinking display | Cleared after 3.5s | 2s minimum "thinking", then 2s of "thought for Ns" (matches SpinnerWithVerb.tsx useEffect) | | Spinner continuity | Mode change reset the spinner glyph to frame 0 | setGlyphs() no longer called on mode change — frame continues | | Live verb text | No trailing ellipsis | Verb… (matches effectiveVerb + '…') | | Status parts order | [thinking, tokens, timer] (reversed) | [timer, tokens, thinking] matching SpinnerAnimationRow.tsx render order | | Stall color | Linear interpolation over 6s | > 0.5 threshold: jump to ERROR_RED once intensity passes midpoint (matches SpinnerGlyph.tsx) |

Behaviors

• Verb: picked once per turn from 186 whimsical options. Stays fixed throughout the turn.
• Glyph: · ✢ ✶ ✻ ✽ ✻ ✶ ✢ · (Linux/Windows) or · ✢ ✳ ✶ ✻ ✽ ✻ ✶ ✳ ✢ · (macOS) at 120ms per frame.
• Live message: ${Verb}… (1m 23s · ↓ 42 tokens · thinking) — verb text with shimmer sweep, status parts inside parens.
• Mode-driven colors:
  • requesting — shimmer sweeps left-to-right (50ms tick), arrow ↑
  • thinking — "thinking" with sine-wave glow after 3s
  • responding — shimmer sweeps right-to-left (200ms tick), arrow ↓
  • tool-input / tool-use — flash oscillates entire verb between base and shimmer
• Stall: if no tokens for 3s and no tools active, verb blends from orange to rgb(171,43,63) over the next 2s. Resets instantly on token arrival.
• Completion: ✻ ${past-tense verb} for ${duration} via notification, randomly picked from ["Baked","Brewed","Churned","Cogitated","Cooked","Crunched","Sautéed","Worked"].