@skillsgate/tui 0.1.10 → 0.1.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillsgate/tui",
-  "version": "0.1.10",
+  "version": "0.1.13",
   "type": "module",
   "bin": {
     "skillsgate-tui": "bin/skillsgate-tui"
@@ -15,13 +15,6 @@
     "@opentui/react": "0.1.90",
     "gray-matter": "4.0.3"
   },
-  "optionalDependencies": {
-    "@skillsgate/tui-darwin-arm64": "0.1.10",
-    "@skillsgate/tui-darwin-x64": "0.1.10",
-    "@skillsgate/tui-linux-x64": "0.1.10",
-    "@skillsgate/tui-linux-arm64": "0.1.10",
-    "@skillsgate/tui-win32-x64": "0.1.10"
-  },
   "peerDependencies": {
     "react": "19.1.5"
   },

package/src/components/agent-filter.tsx

@@ -58,11 +58,11 @@ export function AgentFilter() {
       style={{
         flexDirection: "column",
         width: 22,
-        borderRight: true,
+        border: true,
         borderColor: isFocused ? colors.primary : colors.border,
         backgroundColor: colors.bg,
         paddingTop: 0,
-      }}
+      } as any}
     >
       {/* Library section header */}
       <box style={{ paddingLeft: 1, height: 1, backgroundColor: colors.bgAlt }}>

package/src/components/help-overlay.tsx

@@ -10,20 +10,20 @@ const SHORTCUTS_LEFT: ShortcutEntry[] = [
   { key: "g", description: "Jump to first item" },
   { key: "G", description: "Jump to last item" },
   { key: "v", description: "View skill detail" },
+  { key: "n", description: "Create local skill (home)" },
+  { key: "c", description: "Manage collections (home)" },
   { key: "/", description: "Focus search input" },
   { key: "Tab", description: "Cycle focus: agents > search > list" },
   { key: "Esc", description: "Clear search / go back" },
 ]
 
 const SHORTCUTS_RIGHT: ShortcutEntry[] = [
-  { key: "1/2/3/4", description: "Switch tabs" },
+  { key: "1/2/3", description: "Switch tabs" },
   { key: "s", description: "Open settings" },
   { key: "r", description: "Refresh installed skills" },
-  { key: "l", description: "Login / auth status" },
   { key: "i", description: "Install selected skill" },
   { key: "d", description: "Remove selected skill" },
-  { key: "x", description: "Unfavorite (favorites view)" },
-  { key: "m", description: "Toggle keyword/AI search" },
+  { key: "", description: "" },
   { key: "?", description: "Toggle this help" },
   { key: "Ctrl+Q", description: "Quit" },
   { key: "", description: "" },

package/src/components/layout.tsx

@@ -4,30 +4,22 @@ import { useStore, useDispatch } from "../store/context.js"
 import { useDb } from "../db/context.js"
 import { useDetectedAgents } from "../data/use-agents.js"
 import { useInstalledSkills } from "../data/use-installed-skills.js"
-import { useAuth } from "../data/use-auth.js"
 import { StatusBar } from "./status-bar.js"
 import { HelpOverlay } from "./help-overlay.js"
 import { HomeView } from "../views/home.js"
 import { SkillDetailView } from "../views/skill-detail.js"
 import { DiscoverView } from "../views/discover.js"
-import { FavoritesView } from "../views/favorites.js"
 import { ServersView } from "../views/servers.js"
 import { AddServerView } from "../views/add-server.js"
 import { ServerSkillsView } from "../views/server-skills.js"
 import { SettingsView } from "../views/settings.js"
-import { LoginView } from "../views/login.js"
 import { colors } from "../utils/colors.js"
 import type { ViewName } from "../store/types.js"
 
-function getTabOptions(favCount: number, serverCount: number) {
+function getTabOptions(serverCount: number) {
   return [
     { name: "Installed", description: "Locally installed skills", value: "home" },
     { name: "Discover", description: "Search the registry", value: "discover" },
-    {
-      name: favCount > 0 ? `Favorites (${favCount})` : "Favorites",
-      description: "Your starred skills",
-      value: "favorites",
-    },
     {
       name: serverCount > 0 ? `Servers (${serverCount})` : "Servers",
       description: "Remote SSH servers",
@@ -43,8 +35,7 @@ export function Layout() {
   const { servers } = useDb()
   const [serverCount, setServerCount] = useState(() => servers.list().length)
 
-  // Load auth, agent + skill data on mount
-  useAuth()
+  // Load agent + skill data on mount
   useDetectedAgents()
   useInstalledSkills()
 
@@ -71,14 +62,6 @@ export function Layout() {
       return
     }
 
-    // When on login view, only handle Escape -- let input keys pass through
-    if (state.activeView === "login") {
-      if (key.name === "escape") {
-        dispatch({ type: "GO_BACK" })
-      }
-      return
-    }
-
     // Help overlay toggle
     if (key.name === "?" || (key.shift && key.name === "/")) {
       dispatch({ type: "TOGGLE_HELP" })
@@ -95,21 +78,21 @@ export function Layout() {
     if (state.showHelp) return
 
     // Tab switching (only when not in detail/form views)
-    const inFormView = state.activeView === "detail" || state.activeView === "add-server"
-      || state.activeView === "edit-server" || state.activeView === "settings"
-      || state.activeView === "server-skills" || state.activeView === "login"
+    const activeView = state.activeView as string
+    const inFormView = activeView === "detail" || activeView === "add-server"
+      || activeView === "edit-server" || activeView === "settings"
+      || activeView === "server-skills"
     if (!inFormView) {
       if (key.name === "1") dispatch({ type: "NAVIGATE", view: "home" })
       if (key.name === "2") dispatch({ type: "NAVIGATE", view: "discover" })
-      if (key.name === "3") dispatch({ type: "NAVIGATE", view: "favorites" })
-      if (key.name === "4") {
+      if (key.name === "3") {
         setServerCount(servers.list().length)
         dispatch({ type: "NAVIGATE", view: "servers" })
       }
     }
 
-    // "s" to open settings (only from home/favorites views when not in search)
-    if (key.name === "s" && state.focusedPane !== "search"
+    // "s" to open settings (only from home/servers views when not in search)
+    if (key.name === "s" && (state.focusedPane as string) !== "search"
       && state.activeView !== "discover" && state.activeView !== "detail"
       && !inFormView) {
       dispatch({ type: "NAVIGATE", view: "settings" })
@@ -139,26 +122,20 @@ export function Layout() {
       if (state.installedFilter) {
         dispatch({ type: "SET_INSTALLED_FILTER", filter: "" })
       }
-      if (state.focusedPane === "search") {
+      if ((state.focusedPane as string) === "search") {
         dispatch({ type: "SET_FOCUSED_PANE", pane: "list" })
       }
       return
     }
 
-    // "l" to navigate to login view (always -- allows re-login if token expired)
-    if (key.name === "l" && state.focusedPane !== "search" && state.activeView !== "detail" && state.activeView !== "login") {
-      dispatch({ type: "NAVIGATE", view: "login" })
-      return
-    }
-
-    // "r" to refresh installed skills (when not typing in search, not on login view)
-    if (key.name === "r" && state.focusedPane !== "search" && state.activeView !== "detail" && state.activeView !== "login") {
+    // "r" to refresh installed skills (when not typing in search)
+    if (key.name === "r" && (state.focusedPane as string) !== "search" && activeView !== "detail") {
       dispatch({ type: "REFRESH_SKILLS" })
       return
     }
   })
 
-  const TAB_OPTIONS = getTabOptions(state.favorites.length, serverCount)
+  const TAB_OPTIONS = getTabOptions(serverCount)
 
   const activeTabIndex = TAB_OPTIONS.findIndex(
     (t) => t.value === state.activeView
@@ -186,7 +163,7 @@ export function Layout() {
         }}
       >
         <text fg={colors.primary}>
-          <strong>SkillsGate TUI</strong> <span fg={colors.textDim}>v0.1.0</span>
+          <strong>SkillsGate TUI</strong> <span fg={colors.textDim}>v0.1.12</span>
         </text>
       </box>
 
@@ -194,7 +171,7 @@ export function Layout() {
       <tab-select
         options={TAB_OPTIONS}
         focused={state.activeView !== "detail" && !state.showHelp}
-        selectedIndex={activeTabIndex >= 0 ? activeTabIndex : 0}
+        {...({ selectedIndex: activeTabIndex >= 0 ? activeTabIndex : 0 } as any)}
         selectedBackgroundColor={colors.tabActive}
         selectedTextColor={colors.tabText}
         textColor={colors.textDim}
@@ -216,7 +193,6 @@ export function Layout() {
           <>
             {state.activeView === "home" && <HomeView />}
             {state.activeView === "discover" && <DiscoverView />}
-            {state.activeView === "favorites" && <FavoritesView />}
             {state.activeView === "servers" && <ServersView onServerCountChange={setServerCount} />}
             {(state.activeView === "add-server" || state.activeView === "edit-server") && (
               <AddServerView
@@ -228,7 +204,6 @@ export function Layout() {
               <ServerSkillsView serverId={state.selectedServerId} />
             )}
             {state.activeView === "settings" && <SettingsView />}
-            {state.activeView === "login" && <LoginView />}
             {state.activeView === "detail" && state.selectedSkill && (
               <SkillDetailView />
             )}

package/src/components/status-bar.tsx

@@ -6,16 +6,13 @@ export function StatusBar() {
 
   const skillCount = state.installedSkills.length
   const agentCount = state.detectedAgents.length
-  const user = state.auth?.user?.name ?? "not logged in (l=login)"
   const focusHint = state.activeView === "detail"
     ? "q=back"
-    : state.activeView === "login"
-      ? "Esc=back"
-      : state.focusedPane === "search"
-        ? "Tab=results  Esc=exit search"
-        : "/=search  Tab=switch pane"
+    : state.focusedPane === "search"
+      ? "Tab=results  Esc=exit search"
+      : "/=search  Tab=switch pane"
 
-  const statusText = `Skills: ${skillCount} | Agents: ${agentCount} | ${user} | ${focusHint} | ?=help 1/2/3/4=tabs`
+  const statusText = `Skills: ${skillCount} | Agents: ${agentCount} | ${focusHint} | ?=help 1/2/3=tabs`
 
   return (
     <box

package/src/data/api-client.ts

@@ -1,151 +1,120 @@
-const API_BASE = process.env.SKILLSGATE_SEARCH_API_URL ?? "https://api.skillsgate.ai"
+const SKILLSGATE_API_BASE = process.env.SKILLSGATE_SEARCH_API_URL ?? "https://api.skillsgate.ai"
+const SKILLS_SH_BASE = "https://skills.sh"
+const GITHUB_API_BASE = "https://api.github.com"
+const GITHUB_RAW_BASE = "https://raw.githubusercontent.com"
 
 // ---------- Types ----------
 
 export interface CatalogSkill {
   id: string
-  slug: string
+  skillId: string
   name: string
-  description: string
-  summary?: string
-  categories: string[]
-  capabilities?: string[]
-  keywords?: string[]
-  githubUrl?: string
-  githubStars?: number | null
-  installCommand?: string | null
-  score?: number
-  username?: string
-  urlPath?: string
+  installs: number
+  source: string
 }
 
-interface CatalogResponse {
+interface SkillsShSearchResponse {
   skills: CatalogSkill[]
-  meta: {
-    total: number
-    limit: number
-    offset: number
-    hasMore?: boolean
-  }
-}
-
-interface KeywordSearchResponse {
-  skills: CatalogSkill[]
-  meta: {
-    total: number
-    limit: number
-    offset: number
-    hasMore?: boolean
-  }
+  count: number
 }
 
-interface SemanticSearchResponse {
-  results: CatalogSkill[]
-  meta: {
-    query: string
-    total: number
-    limit: number
-    remainingSearches: number
-  }
-}
-
-export type SearchMode = "keyword" | "semantic"
-
 export interface SearchResult {
   skills: CatalogSkill[]
   total: number
-  remainingSearches?: number
-}
-
-// ---------- Catalog ----------
-
-export async function fetchCatalog(
-  limit: number = 20,
-  offset: number = 0
-): Promise<{ skills: CatalogSkill[]; total: number }> {
-  const url = `${API_BASE}/api/v1/skills?limit=${limit}&offset=${offset}`
-
-  const response = await fetch(url, {
-    headers: { "Content-Type": "application/json" },
-  })
-
-  if (!response.ok) {
-    throw new Error(`Catalog fetch failed (HTTP ${response.status})`)
-  }
-
-  const data = (await response.json()) as CatalogResponse
-  return { skills: data.skills ?? [], total: data.meta?.total ?? 0 }
 }
 
-// ---------- Keyword Search (public, no auth) ----------
+// ---------- Search (skills.sh) ----------
 
-export async function keywordSearch(
+/**
+ * Search for skills or load popular skills when query is empty.
+ * Public endpoint, no authentication required.
+ */
+export async function searchSkills(
   query: string,
   limit: number = 20,
   offset: number = 0
 ): Promise<SearchResult> {
-  const url = `${API_BASE}/api/v1/skills/search?q=${encodeURIComponent(query)}&limit=${limit}&offset=${offset}`
+  // skills.sh requires a minimum 2-char query
+  const q = query.trim() || "skill"
+  const params = new URLSearchParams({ q, limit: String(limit), offset: String(offset) })
 
-  const response = await fetch(url, {
-    headers: { "Content-Type": "application/json" },
-  })
+  const url = `${SKILLS_SH_BASE}/api/search?${params}`
+  const response = await fetch(url)
 
   if (!response.ok) {
-    throw new Error(`Keyword search failed (HTTP ${response.status})`)
+    throw new Error(`Search failed (HTTP ${response.status})`)
   }
 
-  const data = (await response.json()) as KeywordSearchResponse
+  const data = (await response.json()) as SkillsShSearchResponse
   return {
     skills: data.skills ?? [],
-    total: data.meta?.total ?? 0,
+    total: data.count ?? 0,
   }
 }
 
-// ---------- Semantic Search (authenticated, rate limited) ----------
+// ---------- Skill Content (GitHub raw) ----------
 
-export async function semanticSearch(
-  query: string,
-  token: string,
-  limit: number = 5
-): Promise<SearchResult> {
-  const url = `${API_BASE}/api/v1/search`
-
-  const response = await fetch(url, {
-    method: "POST",
-    headers: {
-      "Content-Type": "application/json",
-      Authorization: `Bearer ${token}`,
-    },
-    body: JSON.stringify({ query, limit }),
+/**
+ * In-memory cache for GitHub default branch lookups.
+ */
+const branchCache = new Map<string, string>()
+
+/**
+ * Fetches the default branch for a GitHub repository.
+ */
+async function getDefaultBranch(source: string): Promise<string> {
+  const cached = branchCache.get(source)
+  if (cached) return cached
+
+  const response = await fetch(`${GITHUB_API_BASE}/repos/${source}`, {
+    headers: { Accept: "application/vnd.github.v3+json" },
   })
 
   if (!response.ok) {
-    if (response.status === 429) {
-      throw new Error("RATE_LIMIT")
-    }
-    if (response.status === 401) {
-      throw new Error("AUTH_EXPIRED")
-    }
-    throw new Error(`Semantic search failed (HTTP ${response.status})`)
+    throw new Error(`GitHub API error (HTTP ${response.status})`)
   }
 
-  const data = (await response.json()) as SemanticSearchResponse
-  return {
-    skills: data.results ?? [],
-    total: data.meta?.total ?? 0,
-    remainingSearches: data.meta?.remainingSearches,
-  }
+  const data = (await response.json()) as { default_branch: string }
+  const branch = data.default_branch
+  branchCache.set(source, branch)
+  return branch
 }
 
-// ---------- Unified search ----------
+/**
+ * Candidate paths where a SKILL.md file might be located in a repository.
+ */
+function candidatePaths(skillId: string): string[] {
+  return [
+    `skills/${skillId}/SKILL.md`,
+    `skills/.curated/${skillId}/SKILL.md`,
+    `skills/.experimental/${skillId}/SKILL.md`,
+    `${skillId}/SKILL.md`,
+    `SKILL.md`,
+  ]
+}
 
-export async function searchSkills(
-  query: string,
-  mode: SearchMode,
-  token?: string | null
-): Promise<SearchResult> {
-  if (mode === "semantic" && token) {
-    return semanticSearch(query, token)
+/**
+ * Fetches the SKILL.md content for a skill by trying multiple path candidates
+ * against the GitHub raw content API.
+ */
+export async function fetchSkillContent(
+  source: string,
+  skillId: string
+): Promise<string | null> {
+  const branch = await getDefaultBranch(source)
+  const paths = candidatePaths(skillId)
+
+  for (const p of paths) {
+    const url = `${GITHUB_RAW_BASE}/${source}/${branch}/${p}`
+    const response = await fetch(url)
+    if (response.ok) {
+      return response.text()
+    }
   }
-  return keywordSearch(query)
+
+  return null
 }
+
+// ---------- SkillsGate API (auth, favorites, private skills) ----------
+
+export { SKILLSGATE_API_BASE }

package/src/data/use-favorites.ts

@@ -1,13 +1,27 @@
 import { useState, useEffect, useCallback } from "react"
 import { useStore, useDispatch } from "../store/context.js"
-import type { CatalogSkill } from "./api-client.js"
+import { SKILLSGATE_API_BASE } from "./api-client.js"
 
-const API_BASE = process.env.SKILLSGATE_SEARCH_API_URL ?? "https://api.skillsgate.ai"
-
-interface FavoriteSkill extends CatalogSkill {
+/**
+ * Shape returned by the favorites API endpoint.
+ */
+export interface FavoriteSkill {
+  id: string
+  name: string
+  description: string
+  summary?: string
+  categories: string[]
+  capabilities?: string[]
+  keywords?: string[]
+  githubUrl?: string
+  githubStars?: number | null
+  installCommand?: string | null
+  slug?: string
   favoriteId?: string
 }
 
+const API_BASE = SKILLSGATE_API_BASE
+
 interface UseFavoritesResult {
   favorites: FavoriteSkill[]
   loading: boolean