Three user-visible additions to the web dashboard, plus the CLI surface
needed to drive them.
* `skillshare ui start` / `skillshare ui stop` — run the dashboard as a
managed background process. Re-running start reuses the existing
healthy process; stop uses the remembered host/port. Foreground
`skillshare ui` keeps working unchanged. Process tracking lives in
ui_process_{unix,windows,other}.go via a PID + current-state file.
* `--app` — opens the dashboard in a Chromium app-mode window (Chrome,
Edge, Brave) on macOS, Windows, and Linux for a separate Dock/taskbar
entry without browser chrome.
* In-place upgrade from the browser — the Update dialog and the Doctor
page's Version card now expose an Update now button. Backed by two
new endpoints (POST /api/upgrade, POST /api/restart in
handler_restart_upgrade.go); the browser polls GET /api/health and
reloads once the new server is ready. Dev builds short-circuit with
`devMode: true` and a simulated restart so the flow can be exercised
without rebuilding the binary.
* Progressive Web App — site.webmanifest, app icons (192/512), and a
minimal service worker registered from main.tsx. Supporting browsers
can install the dashboard as a standalone desktop app.
* Doctor Version card redesign — state-coloured icon (blue when an
update is available, green when up to date), explicit
`current → latest` delta, Update button only when there is something
to upgrade.
* i18n — translate "DEV mode" in zh-TW / zh-CN / ko (previously left
as raw English).
Adds CHANGELOG.md and website changelog entries for v0.19.20 and
refreshes website/docs/reference/commands/ui.md to document the new
modes, --app flag, new REST endpoints, and the in-place upgrade flow.
Make the v0.19.16 sources map actually do something: route all path
reads through Config.EffectiveSkillsSource() / EffectiveAgentsSource() /
EffectiveExtrasSource() so users who set sources.skills / sources.agents /
sources.extras get the configured paths everywhere.
Mechanical changes (~50 files):
- cmd/skillshare/**: replace cfg.Source / cfg.ExtrasSource reads with
cfg.EffectiveSkillsSource() / cfg.EffectiveExtrasSource()
- internal/server/**: replace s.cfg.Source / s.cfg.ExtrasSource reads
with the same helpers; server.skillsSource() / gitignoreDir() use the
global-mode helper
- internal/config/config_validate.go: validate using EffectiveSkillsSource
while still rejecting configs that set neither field explicitly
- internal/config/reconcile.go, registry.go: read via helpers
Behavioral fixes (paired with the migration):
- extras init / extras source / POST /api/extras no longer silently
backfill the legacy extras_source field — the runtime fallback inside
EffectiveExtrasSource() handles it. This stops surprise diffs in users'
config.yaml after running extras commands.
- extras source command writes back to whichever field the user already
configured (sources.extras if set, otherwise legacy extras_source) so
the update is not shadowed.
- source_type in /api/extras and extras list correctly reports "default"
vs "extras_source" by inspecting the raw (unresolved) configured value;
sources.extras counts as configured for this purpose.
UI:
- ui/src/lib/fieldDocs.ts: neutralize sources / sources.* descriptions
so they describe both project and global modes (Phase 5).
Preserved (intentional):
- Direct writes to cfg.Source / cfg.AgentsSource / cfg.ExtrasSource in
init, migrate.go, cloneForSave, and server.reloadConfig — these are
raw-field writes, not path reads.
- Updated test expectations for the removed backfills.
- Project mode JSON sync now includes context_cost (was nil)
- Server handler respects symlink mode (skips include/exclude filters)
- checkBudget reports all targets exceeding threshold (not just worst)
- Budget warnings include target name in CLI and UI output
- ConfigPage indentation restored to original 2-space style
The assistant panel already shows field documentation via JSON schema.
A static reference card is redundant and breaks the page's interaction
pattern of cursor-driven contextual help.
Add azure_hosts config parameter (analogous to gitlab_hosts) that allows
users to register self-hosted Azure DevOps Server hostnames so they
receive proper URL parsing without appending .git to clone URLs.
- Add AzureHosts field to Config and ProjectConfig structs
- Add SKILLSHARE_AZURE_HOSTS env var support with merge semantics
- Generalize hostname validation into shared normalizeHostList/mergeHostsFromEnv
- Add azureOnPremPattern regex and parseAzureOnPrem for /_git/ URL routing
- Add isAzureHost for config-based host detection (no auto-detect)
- Update TrackName to handle on-prem Azure DevOps clone URLs
- Wire AzureHosts through InstallContext, ParseOptions, and Server
- Add JSON Schema, UI fieldDocs, and website documentation
- Add 19 new tests covering config, source parsing, and server
Closes#147
- Add ErrSkillNotFound sentinel error in search/preview.go so callers
can distinguish 404 from other errors with errors.Is instead of
brittle string matching
- Cap previewCache at 200 entries with TTL purge + full reset on
overflow to prevent unbounded memory growth
- Make Card and SearchResultsTable rows keyboard-accessible
(role=button, tabIndex=0, Enter/Space handlers)
- Refactor SkillPreviewModal to accept a single SearchResult prop
instead of 6 individual fields — reduces prop drilling and keeps
the modal in sync with the result shape
- Fix search_online_test: add --list flag so output is not gated
behind interactive TUI
Add a preview modal so users can read a skill's SKILL.md content
before installing. Clicking a search result card or table row opens
the modal; the Install button is now inside the modal.
Backend:
- New GET /api/preview?source=owner/repo/path endpoint
- FetchSkillContent fetches SKILL.md from GitHub Contents API
- Git Tree API fallback for hub sources where the install shorthand
doesn't match the repo's actual file path
- In-memory TTL cache (5 min) via sync.Map
- Proper 404/429/500 error handling with rate-limit support
Frontend:
- SkillPreviewModal component (DialogShell-based, lazy-fetch)
- Cards and table rows clickable to open preview
- Graceful fallback: if fetch fails but hub metadata exists, show
description + tags instead of error
- Hide Stars column in table view for hub mode
- Fix Card component missing onClick prop passthrough
- Fix IntersectionObserver not reconnecting after loading more items
- Prevent background scroll when any modal is open (DialogShell)
- i18n keys added to all 11 locales
Closes#141
Add PATCH /api/resources/{name}/source endpoint to update the source URL
for installed skills. For tracked repos, all sibling skills sharing the
same git remote are updated together with the new repo base URL, and the
git remote origin is also updated.
Frontend changes:
- Add Source URL input field in the skill editor (visible for all skills
with metadata)
- Use shared Input/Textarea components in FrontmatterEditor for visual
consistency, with new size='sm' variant
- Replace custom kind-badge/tracked-badge with shared KindBadge/SourceBadge
components in the editor header
- Preserve original YAML frontmatter formatting when only the body or
source URL is changed (avoids spurious quote style / line wrap diffs)
- Skip diff review dialog when only source URL is modified
Backend fixes:
- Two-pass skill lookup in handleGetSkill: prefer exact FlatName match
over baseName fallback to prevent name collisions between standalone
and tracked repo skills
- Add basename-only fallback in MetadataStore.GetByPath for tracked repo
skills stored with short keys
- Use cfg.Source (global) consistently in save/patch handlers to match
the source used by list/detail handlers in project mode
Closes#142
Extract highlightArgs utility from SkillEditor to shared lib so both
the editor and ResourceDetailPage render $ARGUMENTS with the warning
badge style.
- Add p/li component overrides in ResourceDetailPage mdComponents
- Move .arg-token CSS from scoped editor styles to global index.css
- Simplify argsCount to hasArgs boolean (count display removed)
- Remove ×{count} prefix from argsHint in all 11 locales
The shared SegmentedControl has no gap between icon and label, making
Edit/Split/Preview look cramped. Revert the visual to the original
editor-themed .seg-btn/.seg-group CSS (4px icon gap, paper background,
shadow-sm active state).
Keep the DRY JSX win by introducing a small EditorSegment helper that
renders the same markup the three inline call sites previously duplicated.
resolveFieldPath() was intentionally updated in 7c913086 to treat bare
list values like "- skill-a" as resolvable keys (for short-form target
name docs lookup), but the corresponding test still asserted the old
null-returning behaviour and had been failing silently ever since.
Follow-up to the earlier simplify pass — addresses the larger refactors
called out by the three review agents:
- Drop local SegmentedField in favour of the shared SegmentedControl used
across the dashboard; reuse it for the Fields/YAML toggle, the
Edit/Split/Preview mode switcher, and the enum frontmatter fields. Removes
~34 lines of duplicated .seg-group / .seg-btn CSS.
- Split the 80-line FrontmatterField if/else into per-type subcomponents
(EnumField / BoolField / ArrayField / TextField) dispatched from a small
FieldControl switch. The synthetic 'conditional' field type is gone —
visibility is now a plain 'showWhen' predicate on a 'text' field, with an
optional 'placeholder' override.
- Extract a shared CollapsibleGroup wrapper; both FrontmatterGroup and
FrontmatterMetadataGroup use it, deleting the copy-pasted fm-group chrome.
- requestAnimationFrame-throttle the synced-scroll handlers. Previously
every onScroll event (~60×/s) ran buildSyncAnchors, which measures
scrollHeight / getComputedStyle / querySelectorAll and sometimes the DOM
mirror. Now one pass per frame per scroll source, with RAF + timer
cleanup on unmount.
useLineDiff consolidation was considered but skipped — computeLineDiff
returns only add/remove rows, whereas DiffView needs the eq rows for the
side-by-side view, so merging would complicate the shared hook.
- Drop unused EditorCustomField / initialCustomFields / draftTargets / FileText
re-export; narrow onSaved signature to (nextContent: string).
- Gate DiffView render on showDiff so the O(n·m) LCS + composeSkillMarkdown
don't run on every keystroke while the dialog is closed.
- Route the markdown preview and Outline through useDeferredValue so typing
stays responsive while react-markdown catches up.
- Serialize frontmatter YAML lazily (only when yamlMode is active).
- Equality-guard the metadata-row reconcile effect to avoid no-op setState
storms on every frontmatter keystroke.
- Memoize derived stats (tokens/words/lines) into a single pass instead of
two splits per render.
- Replace the private YAML parser in ResourceDetailPage with
lib/frontmatter's parseSkillMarkdown; removes ~60 LOC of duplicate logic.
- Remove WHAT-narrating comments ("Keyboard shortcuts", "Derived stats",
"Stage 1: Content Stats Bar", etc.).
Introduces a full in-browser skill editor reachable from the skill detail
page, replacing the previous read-only detail view for edits.
Editor
- Two-pane layout with Markdown textarea, live preview, and synced scroll
- Edit / Split / Preview mode toggle in the status bar (⌘P to cycle)
- Keyboard shortcuts: ⌘S save (with diff review), Esc cancel
- Outline drawer with jump-to-heading
- Token / word / line / file count in status bar, 5K budget warning
Frontmatter
- Grouped field editor (Identity / Invocation / Execution / Metadata)
matching the 13 official SKILL.md fields
- Shared 1,536-char budget enforced across description + when_to_use
- Switch toggles for booleans, segmented control for enums, chip array
inputs for list-valued fields
- Metadata group edits nested metadata.* keys directly, with stable row
ids so typing key → clicking value no longer remounts the inputs
- Special handling for metadata.targets so values serialize as a YAML
list (backend ParseFrontmatterList requires arrays)
- YAML mode for raw editing; Fields ↔ YAML round-trips cleanly
- Legacy root-level 'targets:' migrated to metadata.targets on load
Diff review
- Save triggers a side-by-side diff modal built on the shared DialogShell
with focus trap and backdrop, using the Button component for actions
- YAML serializer emits plain scalars when safe instead of wrapping every
value containing ':', '*', '#', or '"', eliminating spurious churn in
the save diff
Misc
- DialogShell gains 4xl–7xl maxWidth presets
- Resource detail sidebar shows a Targets row when metadata.targets is set
Backend additions (server handlers):
- POST /api/resources/:name/content save SKILL.md content
- POST /api/resources/:name/open open in local editor
Add agentLocalCount to target API and CLI JSON output so the UI can
display how many local (non-source) agents exist per target.
- Add LocalCount to AgentSummary, computed via FindLocalAgents
- Surface agentLocalCount in both CLI target list JSON and server API
- Show local agent counts in target detail summaries (CLI + UI)
- Collect button now appears for targets with local agents and routes
to CollectPage with scope=agent query param
- CollectPage reads scope from URL and auto-scans on mount
- Fix BatchUninstallPage: agents tab was collapsing individual agent
names into the repo name via buildApiNames(), causing 'agent not
found' errors; now sends each agent flatName individually
- Invalidate targets + diff queries after successful collect
The empty state always displayed skill-related copy (icon, title,
description) regardless of which tab was active. Now it switches to
agent-specific text and the Bot icon when the Agents tab is selected.
UpdatePage uses variant="warning" on the Force Retry button for
blocked items to visually distinguish them from error-state Force
Retry (which uses danger). The Button component didn't expose a
warning variant, causing the Docker build to fail with a TS2322
type error.
Adds warning alongside existing danger variant, mirroring the same
outlined-with-hover-fill pattern and matching the warning color
scheme already used by Badge and in-line text-warning classes.
The large StreamProgressBar appeared between the PageHeader and the tab
bar when checking started, pushing the whole list down. Loading state
is already conveyed by the Check All / Check Selected button spinners
and the per-item 'Checking' badges, so the big bar was redundant.
Check results were keyed by repo directory name (e.g. _awesome-claude-agents)
while UI items used per-skill names (api-architect, backend-developer, ...).
applyCheckResult now iterates updatable items and maps each repo's status
to all items belonging to it, so tracked repo entries no longer get stuck
in the Checking state.
- Store api.updateAllStream() return value in esRef so unmount cleanup
closes both check and update EventSource connections
- Extract ItemStatusCard component to deduplicate ~50 lines of per-item
status card rendering between updating and done phases
- Wrap successCount/skippedCount/blockedCount/errorCount in a single
useMemo pass instead of 4 separate .filter() calls
- Move globToRegex to ui/src/lib/glob.ts shared utility, imported by
both UpdatePage and BatchUninstallPage
- CheckItemStatus: change from flat string union to interface with
status, message?, and behind? fields; applyCheckResult now preserves
repo.behind and repo.message; CheckStatusBadge renders 'N behind'
- Done phase: blocked items now show Force Retry button (variant=warning)
- Search filter: add globToRegex for glob pattern matching (* and ?)
- Check button loading: track checkMode ('all'|'selected'|null) state
so loading spinner shows on the correct button regardless of selection
Replace the old idle/updating/done flow with a new three-phase state machine:
- selecting: Virtuoso checkbox list of all tracked + GitHub skills with
sticky search bar, SegmentedControl type filter (All/Tracked/GitHub),
Select All/Deselect All, and per-item CheckStatusBadge
- updating: StreamProgressBar + per-item status cards with auto-scroll
- done: Summary card with badges + per-item result cards with
Force Retry/Purge buttons + Back to List
Key changes:
- No auto-check on mount; manual Check All / Check Selected buttons
- Check results stored in Map<string, CheckItemStatus> with 6 states
- Unified selection via Set<string> (no split repos/skills)
- Repo deduplication in handleUpdate (same repo = one update)
- Action buttons in PageHeader (not bottom bar)
- No confirm dialog before update
- useQuery for skills list (replaces inline SSE-only check)
Add GET/PUT /api/agentignore endpoints mirroring the existing
skillignore API, backed by skillignore.ReadAgentIgnoreMatcher()
and resource.AgentKind{}.Discover() for ignore stats.
On the frontend, extend the Config page with a third tab for
editing .agentignore. Generalize the former SkillignoreTab into
a shared IgnoreTab component with a kind prop, and extend
AssistantPanel to show ignored agents in the sidebar.
- Rename 'Uninstall Skills' → 'Uninstall Resources' on BatchUninstallPage
- Rename 'Pull local skills' → 'Pull local resources' on CollectPage
- Rename 'Push your skills' → 'Push resources' on SyncPage
- Compact Sync/Collect action bars: inline SegmentedControl + button
on the same row instead of stacked vertically
- Replace badge grid sync summary with inline text stats (dot-separated)
showing totals with a secondary skill/agent breakdown line
- Simplify 'all in sync' state to single-line inline layout
The Track badge in SkillPostit was redundant with the existing Tracked
indicator at the bottom. Revert to Users icon — Track badge is only
used in the folder tree view.
- Replace flex-wrap badge layout with CSS Grid for aligned KindBadge rows
- Fix ignored count showing only skills instead of total (skills + agents)
- Group ignored items by kind (skill/agent) with KindBadge sub-headers
- Increase spacing between groups for better visual hierarchy
Agent discovery was treating non-agent files (CLAUDE.md, AGENTS.md, etc.)
as agent resources when they appeared in tracked repos.
Two fixes:
- Expand ConventionalExcludes with 7 well-known convention filenames
(CLAUDE.md, AGENTS.md, GEMINI.md, COPILOT.md, CONTRIBUTING.md,
CODE_OF_CONDUCT.md, SUPPORT.md)
- For tracked repos with an agents/ subdirectory, only discover files
inside agents/ — skip repo root files and other subdirs (docs/, etc.)
Also includes UI polish:
- Display flat names (__ separator) as path separators in toasts/labels
- Consolidate batch install errors into single toast
- Show .agentignore state in sync diff/preview responses
- Track badge + friendly repo name in resource list/folder tree
- auditCache: centralized cache with installed-count staleness check
- resourceNames: agent display name formatting (strip .md suffix)
- AuditPage: skip audit when 0 installed, show empty state per kind
- clearAuditCache on install/uninstall/update across all pages
- ResourcesPage: agent target summary, context menu for agents
- FilterStudioPage: agent display name in preview search
- SkillPickerModal: accessible radio button (button element)
- fieldDocs: agents sub-keys no longer marked reserved
- Integration tests: diff/sync prune after uninstall-all, tracked agent install
Add local-path resource discovery so install flows can detect agents as well as skills. Preserve nested agent paths and suffixless agent metadata keys during batch install and update, and refresh the UI copy to use resource-aware wording on the install surface.
CollectPage now has Skills/Agents/Both scope selector matching
SyncPage pattern. Scan and collect operations pass kind to API.
Selected set uses 3-segment key (target/kind/name) to prevent
collision between skills and agents with same name.
- Fix data race: read agentsSource inside RLock in handleDiffStream
- Validate kind param in handleSync (reject invalid values)
- Add test for symlink-points-elsewhere agent diff case
- Always show KindBadge on DiffItemRow (default to 'skill')
- SegmentedControl with Skills / Agents / Both options (default: Both)
- Sync button text and API kind param change with selection
- Diff summary shows separate skill/agent counts with KindBadge
- Split button labels (Force Sync) also reflect scope