- Filter Studio page (/targets/:name/filters) — two-column layout with
pattern editing (left) and live preview with search (right). Click-to-
toggle, 500ms debounced preview, unsaved changes detection
- TargetsPage: always-visible filter summary line with tag preview
(max 3, +N more overflow) replacing hidden ghost Filters button
- SkillDetail: Target Distribution read-only sidebar card showing
per-target sync status with links to Filter Studio
- SkillDetail: post-it pastel styling — semantic colors per card type
(yellow/blue/cyan/green), thumbtack pins, tape decoration, hand-drawn
borders (playful theme only). Clean theme uses white backgrounds
- useSyncMatrix hook wrapping GET /api/sync-matrix via React Query
- Unified input borders (border-2 border-muted) across all form controls
- FilterTagInput auto-commits on blur to prevent lost input
Wrap both the empty state and extras list inside the data-tour
container so the guided tour can locate [data-tour='extras-list']
even when no extras are configured. Also add emptyDescription to
the extras tour step for a friendlier empty-state message.
Replace list.DefaultDelegate + configureDelegate() with a new
prefixItemDelegate that renders the "▌" prefix bar consistently
across all 11 TUI list views (log, trash, search, install prompt,
checklist, restore, audit rules, diff).
- Add prefixItemDelegate (1-line) and renderPrefixRowWithDesc (2-line)
- Remove configureDelegate(), NormalTitle/Desc, SelectedTitle/Desc styles
- Remove hardcoded " " indent from restore item Title() methods
- Fix AuditPage overflow handling with overflow prop and !overflow-clip
Backup: replace individual restore buttons with a dropdown menu when
targets exceed 3, preventing horizontal overflow. Dropdown auto-detects
viewport edge to open upward or downward. Button component now supports
ref forwarding for position measurement.
Sidebar: make bottom tools section (theme, tour, shortcuts) collapsible
with localStorage persistence.
- Push/Pull columns use flex-col + flex-1 so checkbox/button rows
align at the same vertical position regardless of content height
- Result messages moved to content area above the action footer
- Playful theme sidebar uses --color-paper instead of plain white
Allow non-technical users to switch git branches from the Web UI
without needing a terminal.
Backend:
- Add ListLocalBranches, ListRemoteBranches, Checkout to git layer
- Add GET /api/git/branches and POST /api/git/checkout endpoints
- Dirty-check guard prevents checkout with uncommitted changes
Frontend:
- Branch dropdown (HandSelect) with local/remote branch options
- Refresh button to fetch latest remote branches
- Repo Info Card restructured with status bar layout
- Push/Pull merged into single card with dashed grid divider
Allow non-technical users to switch branches from the Web UI without
needing a terminal. The dropdown shows local branches first, then
remote-only branches tagged "(remote)".
Backend:
- Add ListLocalBranches, ListRemoteBranches, Checkout to internal/git
- Add GET /api/git/branches (?fetch=true for remote discovery)
- Add POST /api/git/checkout with dirty-check guard + fetch-before-switch
- Oplog instrumentation for checkout operations
Frontend:
- Branch Select dropdown replaces static text when >1 branch exists
- Refresh button to fetch new remote branches on demand
- Dirty state disables switching with visual hint
- Card overflow + z-index fix for playful theme dropdown clipping
Replace the minimal Repo Status Card with a full Repository Info Card
showing remote URL with platform detection (GitHub/GitLab/Bitbucket),
branch tracking info, HEAD commit hash and message, and status badges.
Backend: export GetRemoteURL, add GetHeadMessage and GetTrackingBranch
to internal/git, extend /api/git/status with 4 new fields.
Frontend: new parseRemoteURL utility parses SSH/HTTPS remote URLs and
detects platform by exact hostname match. RepoInfoCard displays parsed
owner/repo with platform icon, clickable link, copy button, and
graceful fallbacks for missing remote or unparseable URLs.
The update handler used internal/git which ran git commands without
capturing stderr, so failures like divergent branches only showed
"exit status 128". Now runGitWithProgress captures stderr and pipes
it through install.WrapGitError for meaningful messages.
Also adds:
- extractGitFatal() strips verbose hint: lines from git output
- Force checkbox and per-item Force retry button in Update UI
- "(try force update)" / "(try --force)" hint on pull failures
Add ability to change sync mode of an extra's target across all three
interfaces: CLI (`extras mode`/shorthand `extras <name> --mode`),
TUI (`M` key with mode picker overlay), and Web UI (inline Select
dropdown per target with PATCH /api/extras/{name}/mode endpoint).
Fix sync behavior so symlinks from a previous mode are auto-replaced
without --force, while regular files still require explicit --force.
Consolidate sync mode list into config.ExtraSyncModes single source
of truth. Fix Select component missing disabled prop and add viewport
collision detection with useLayoutEffect.
Includes 8 integration tests covering mode command happy path, error
cases, shorthand syntax, and mode-switch sync behavior.
Extras commands had multiple issues with tilde (~) path handling — Go
doesn't expand ~ (that's shell behavior), so paths like ~/.claude/rules
were treated as literal relative paths, creating bogus ~/ directories.
Key fixes:
- Export config.ExpandPath() and call it before os.Stat / sync operations
in extras_list, sync_extras, extras_collect, and doctor
- Unify extras output headers to match target list style (single "Extras"
header instead of per-extra headers, fix double-icon bug in list)
- Add per-target reachability warning in doctor for unreachable extras
targets with expanded path display
Update all 3 E2E runbooks to use extras/<name>/ path layout, add /tmp
cleanup for idempotent re-runs, add migration test step, and create new
comprehensive extras_commands_runbook (18 steps covering init/list/remove/
collect/doctor/tilde/project-mode).
Improve cli-e2e-test skill with 4 new checklist items and 2 rules learned
from test friction (/tmp isolation, symlink write-through, cat>>
idempotency, extras path layout).
- CopyButton: add focus ring, active:scale-95, remove unused style prop
- FileViewerModal: use IconButton for close, Spinner for loading state
- SkillDetailPage: fix sticky sidebar not scrollable when content overflows viewport
- Update pnpm-lock.yaml for test dependencies added by PR #76
- Add salmonumbrella and daylamtayari to README contributors
Self-built tour engine: TourProvider (context + state machine),
TourOverlay (spotlight cutout via box-shadow), TourTooltip (positioned
bubble with arrow, progress dots, mobile bottom sheet).
14 steps covering all sidebar sections. Auto-adjusts for project mode
(skips Git Sync) and empty state (no skills). Keyboard accessible
(Escape/Arrow/Enter). Triggered via sidebar Quick Tour button.
- SearchPage: add card/table view toggle with pagination, sticky toolbar,
and localStorage persistence for view preference
- AuditPage: replace generic PageSkeleton with StreamProgressBar for
seamless loading-to-progress transition
- AuditPage: fix triage panel help text alignment with selector input
by matching py-1.5 padding
- SkillsPage: add sticky thead and scrollable table body
- Change tag badges from accent to info variant
Replace left-border colored stripes with severity dots across all pages
(AuditPage, AuditRulesPage, InstallForm, GitSyncPage, SkillsPage) and
components (Card accent variant, ConfirmDialog, Select). Card accent now
uses a thicker border instead of a left stripe.
Fix Cmd+S modifier HUD staying visible by resetting state immediately
after shortcut fires and adding a 2-second auto-dismiss safety timer.
Additional refinements: extract Checkbox/Select/Spinner/Tooltip into
standalone components, update Button link variant to pencil colors,
replace SkillsPage FilterChips with SegmentedControl connected, and
update style guide to mark left-border stripes as an anti-pattern.
Removes the anti-pattern of calling setState synchronously inside
useEffect to reset pagination when skills list changes. Uses React's
recommended "adjusting state during rendering" pattern instead, which
avoids cascading re-renders.
- Add Cmd/Ctrl+S shortcut to navigate to Sync page (cross-platform)
- Show floating HUD bar when holding Cmd/Ctrl to reveal modifier shortcuts
- Add indeterminate shimmer progress bar during sync operations
- Animate SVG pipeline dashed lines with flow effect while syncing
- Update KeyboardShortcutsModal to render modifier key combos (⌘/Ctrl)
- Add ScrollToTop button for long-scrolling pages
- Migrate page styles to use shared design tokens (radius, shadows)
Replace horizontal icon+text buttons with vertical layout matching
the nav item style (icon + label, same padding/gap). Add keyboard
shortcuts toggle button and global shortcut hook integration.
Replace Virtuoso with GroupedVirtuoso for the grouped view so that
directory sub-headers stick below the toolbar while scrolling.
GroupedVirtuoso's TopItemList component is customized with the
measured toolbar height offset to position headers correctly.
- Add border to active button in connected SegmentedControl so it's
visible in dark mode (bg-surface was nearly invisible against container)
- Increase sticky toolbar bottom padding (pb-2 → pb-4) for breathing
room between filter chips and content
- Tighten sticky toolbar gaps (search mb-4→mb-2, chips mb-6→mb-0)
- SegmentedControl connected mode: add p-1 inner padding + gap-0.5,
active state from solid black to white surface with shadow
- Input: border-radius 4px→8px, focus ring matches pencil palette
Wrap search bar, sort dropdown, view toggle, and filter chips in a
sticky container so they stay pinned while scrolling through skills
in all three view modes (grid/grouped/table).
Also clean up LogPage: remove unused imports, simplify status rendering
from Badge to inline dot+text, add pagination page size control, and
streamline section comments.
- Extract shared PageHeader with icon/title/subtitle/actions props,
replacing duplicated header markup across all 16 pages
- Shrink Badge to text-xs with tighter padding for subtler appearance
- Change StatusBadge normal states (merged/copied/linked) to default
grey variant — only anomalies (warning/danger) use color
- TargetsPage: move delete button to top-right, restore dashed separator
between path and mode row
- Move filter link and skill count inline with sync mode dropdown,
eliminating separate rows and the dashed separator
- Use ghost variant for Filters button to match neutral B/W theme
- Show filter tags with Edit link when filters exist, inline link when empty
- Remove redundant Version card from DashboardPage stats grid
- Change dropdown panel from w-full to min-w-full so it can grow
wider than the trigger when descriptions need more space
- Remove truncate from option description text
- Restructure TargetsPage filter section: only show filter UI for
merge/copy modes, add inline filter badge display with +/− labels
- Redesign Select with size variants (sm/md), B/W color scheme,
dropdown animation, and consistent height with Button/Input
- Extract DialogShell for unified modal styling across all dialogs
- Add IconButton for icon-only actions with ghost/outline variants
- Add Pagination component for table views
- Add SegmentedControl for tab-like toggle groups
- Update Button: add link variant, border-2 for stronger presence
- Migrate all pages to use shared components, remove inline styles
Skills page gains a third "table" view with paginated list (10/25/50),
hover tooltips via createPortal, and localStorage persistence for the
selected view. Grouped view now uses Virtuoso for smooth scrolling with
large skill sets.
Install/audit dialogs refactored to card-based findings with severity
filter badges, structured grouping, and increased max-height. Confirm
dialog buttons bumped to medium size.
- Dark mode: replace blue accent with neutral gray for true B/W inversion
- Brighten dark mode semantic colors (success, warning, danger) for readability
- Links: replace wavy underlines with oMLX-style border-bottom (link-subtle class)
- Buttons: pill radius, outlined danger, subtle secondary/ghost hover
- Replace inline fontFamily monospace with global font-mono class (15+ files)
- Card: add overflow prop instead of global overflow-hidden removal
- ConfirmDialog/ExtrasModal: widen for better readability
- SkillsPage: neutral filter chips and badges (no blue/red in dark mode)
- BlockStamp/RiskMeter: consistent sizing with items-stretch
- Sidebar version: dynamic from API instead of hardcoded
- Remove all --color-postit-* and --color-tracked-* stub CSS variables
from both @theme and .dark blocks in index.css
- Remove `postit` variant and `decoration` prop from Card.tsx
- Replace bg-postit Tailwind classes with bg-paper/bg-surface equivalents
- Replace animate-spin-slow/animate-pulse-gentle with standard animate-spin/animate-pulse
Replace wobbly->radius, colors->palette, animate-sketch-in->animate-fade-in.
Remove all fontFamily var(--font-hand/heading) inline styles, decoration="tape",
variant="postit", and decorative rotate transforms. Rewrite SkillsPage card
components to use uniform surface-background cards with accent border-l for
tracked skills, dropping the postit/trackedColors arrays and getRotation helper.
Replace hand-drawn skeuomorphic styles (wobbly borders, shadow-translate
hover effects, handwriting font) with clean, minimal equivalents using
the updated radius/shadows tokens. Preserve all props and keyboard
navigation for backward compatibility.
- ExtrasPage with list, sync, remove, and add-extra modal
- API client types and methods for extras endpoints
- Dashboard stat card showing extras count/files/targets
- Nav item and route registration
Add a copy button (overlapping-squares icon) to the skill detail page:
- Next to the "Path" label in the Metadata card, copies the full
absolute source path
- In the file viewer modal header, copies the full file path
Clicking shows a brief checkmark with "Copied!" confirmation.
AuditPage: use Virtuoso with useWindowScroll for skill audit cards.
SyncPage: use Virtuoso with fixed-height container for diff items
(100+ threshold), flat render for small lists.
Replace sequential POST loops and blocking useQuery calls with
Server-Sent Events for real-time progress feedback on Update, Check,
and Diff operations. Extract shared helpers to reduce duplication:
- initSSE() in middleware.go consolidates SSE preamble across 4 handlers
- createSSEStream() in client.ts unifies EventSource lifecycle management
- StreamProgressBar component replaces 3 near-identical progress bars
- handleDiff now delegates to computeTargetDiff (eliminates ~150 lines)
- Paginate audit results (20 cards + 10 findings per card) to prevent
DOM overload with large skill counts