Pawse: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

What this is

pawse (mascot: the lion Leo) — an interactive widget for Claude Code, built as a single PowerShell + WPF script wired into Claude Code hooks. When Claude stops or needs input, a desktop popup appears; the user types a reply in the widget and Claude continues. Windows-only, no install/build step. See README.md for user-facing docs.

Commands

There is no build/compile — it's an interpreted PowerShell script. Use Windows PowerShell 5.1 (powershell.exe), not pwsh (see STA note below).

# Logic tests (no GUI): danger regex, UTF-8 round-trip, transcript preview, syntax check
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\plugin\test-widget.ps1

# Manual GUI test — pipe a sample hook JSON to one event
'{"hook_event_name":"Stop","stop_hook_active":false,"transcript_path":""}' | powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\plugin\claude-widget.ps1 -Event Stop
'{"tool_name":"Bash","tool_input":{"command":"rm -rf build"}}'             | powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\plugin\claude-widget.ps1 -Event PreToolUse
'{"notification_type":"idle_prompt","message":"hi"}'                        | powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\plugin\claude-widget.ps1 -Event Notification

# Syntax check without running
$e=$null; [System.Management.Automation.Language.Parser]::ParseFile((Resolve-Path .\claude-widget.ps1),[ref]$null,[ref]$e); $e

Because the widget windows are modal (ShowDialog), automated render-testing launches the script as a child process, sleeps ~2s, checks HasExited (still running ⇒ XAML parsed & window shown), then Kill()s it. See the test harness pattern used during development.

Architecture

claude-widget.ps1 is a single entry point: -Event Stop|Notification|PreToolUse. Flow:

1. Read hook JSON from stdin → load config.psd1 → compute light/dark palette (from Mode, or the system theme via HKCU:\...\Themes\Personalize\AppsUseLightTheme).
2. switch ($Event) builds an event-specific WPF window from an inline XAML here-string and shows it.
3. The chosen decision is written to stdout as compact JSON; everything else (the window, errors) must stay off stdout.