@skillsgate/tui 0.2.0 → 0.2.4

package/bin/postinstall.cjs

@@ -16,7 +16,7 @@ const pkg = platformMap[os.platform()]?.[os.arch()];
 if (!pkg) process.exit(0);
 
 // Check if already available as a sibling (optionalDeps worked)
-const siblingPath = path.join(__dirname, "..", "..", "..", `@skillsgate/${pkg}`);
+const siblingPath = path.join(__dirname, "..", "..", `@skillsgate/${pkg}`);
 if (fs.existsSync(siblingPath)) process.exit(0);
 
 // Also check nested node_modules
@@ -27,11 +27,20 @@ try {
 
 // Not found — install it explicitly
 const version = require("../package.json").version;
+const fullPkg = `@skillsgate/${pkg}@${version}`;
 try {
-  execSync(`npm install -g @skillsgate/${pkg}@${version} --no-save`, {
+  execSync(`npm install -g ${fullPkg} --no-save`, {
     stdio: "inherit",
     timeout: 30000,
   });
 } catch {
-  console.warn(`Warning: could not install @skillsgate/${pkg}. Run manually: npm install -g @skillsgate/${pkg}`);
+  console.warn(`Could not install ${fullPkg}, falling back to @latest (versions may differ)`);
+  try {
+    execSync(`npm install -g @skillsgate/${pkg}@latest --no-save`, {
+      stdio: "inherit",
+      timeout: 30000,
+    });
+  } catch {
+    console.warn(`Warning: could not install @skillsgate/${pkg}. Run manually: npm install -g @skillsgate/${pkg}`);
+  }
 }

package/bin/skillsgate-tui

@@ -25,14 +25,34 @@ const binName = platform === "win32" ? "skillsgate-tui.exe" : "skillsgate-tui";
 const require = createRequire(import.meta.url);
 const thisDir = path.dirname(fileURLToPath(import.meta.url));
 
-function findBinary() {
+function getNpmGlobalRoot() {
+  try {
+    return execFileSync("npm", ["root", "-g"], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+      timeout: 10000,
+    }).trim();
+  } catch {
+    return null;
+  }
+}
+
+function findBinary({ includeGlobal = false } = {}) {
   const candidates = [
     // Nested node_modules (local installs)
     () => require.resolve(`@skillsgate/${pkg}/${binName}`),
     // Sibling in global node_modules (npm install -g)
-    () => path.join(thisDir, "..", "..", "..", `@skillsgate/${pkg}`, binName),
+    () => path.join(thisDir, "..", "..", `@skillsgate/${pkg}`, binName),
   ];
 
+  if (includeGlobal) {
+    candidates.push(() => {
+      const globalRoot = getNpmGlobalRoot();
+      if (!globalRoot) throw new Error("npm global root not found");
+      return path.join(globalRoot, `@skillsgate/${pkg}`, binName);
+    });
+  }
+
   for (const resolve of candidates) {
     try {
       const p = resolve();
@@ -54,9 +74,16 @@ if (!binPath) {
   console.error(`Installing platform binary (${fullPkg})...`);
   try {
     execSync(`npm install -g ${fullPkg}`, { stdio: "inherit", timeout: 30000 });
-    binPath = findBinary();
+    binPath = findBinary({ includeGlobal: true });
   } catch {
-    // fall through to error below
+    // Fallback to latest if exact version is not published for this platform
+    console.warn(`Could not install ${fullPkg}, falling back to @latest (versions may differ)`);
+    try {
+      execSync(`npm install -g @skillsgate/${pkg}@latest`, { stdio: "inherit", timeout: 30000 });
+      binPath = findBinary({ includeGlobal: true });
+    } catch {
+      binPath = findBinary({ includeGlobal: true });
+    }
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillsgate/tui",
-  "version": "0.2.0",
+  "version": "0.2.4",
   "type": "module",
   "bin": {
     "skillsgate-tui": "bin/skillsgate-tui"

package/src/components/agent-filter.tsx

@@ -15,6 +15,12 @@ export function AgentFilter() {
   const { servers } = useDb()
 
   const allCount = state.installedSkills.length
+  // Count favorites that are currently installed.
+  const favSet = new Set(state.favorites)
+  const favoritesCount = state.installedSkills.reduce(
+    (n, s) => (favSet.has(s.name) ? n + 1 : n),
+    0,
+  )
 
   // Remote servers with skill counts
   const serverList = servers.list()
@@ -38,7 +44,7 @@ export function AgentFilter() {
     if (state.focusedPane !== "agents") return
     if (state.showHelp) return
 
-    const allOptions = ["all", ...agentOptions.map((o) => o.value)]
+    const allOptions = ["all", "favorites", ...agentOptions.map((o) => o.value)]
     const currentIdx = allOptions.indexOf(state.selectedAgentFilter)
 
     if (key.name === "up" || (key.name === "k" && !key.ctrl)) {
@@ -84,6 +90,21 @@ export function AgentFilter() {
         <text fg={colors.textDim}> ({allCount})</text>
       </box>
 
+      {/* Favorites */}
+      <box
+        style={{
+          paddingLeft: 1,
+          paddingRight: 1,
+          height: 1,
+          backgroundColor: state.selectedAgentFilter === "favorites" ? colors.bgAlt : "transparent",
+        }}
+      >
+        <text fg={state.selectedAgentFilter === "favorites" ? colors.primary : colors.text}>
+          {"★ "}Favorites
+        </text>
+        <text fg={colors.textDim}> ({favoritesCount})</text>
+      </box>
+
       {/* Spacer */}
       <box style={{ height: 1 }}>
         <text>{" "}</text>

package/src/components/help-overlay.tsx

@@ -10,6 +10,7 @@ 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: "f", description: "Toggle favorite on selected skill" },
   { key: "n", description: "Create local skill (home)" },
   { key: "c", description: "Manage collections (home)" },
   { key: "/", description: "Focus search input" },

package/src/components/layout.tsx

@@ -4,6 +4,7 @@ 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 { useFavorites } from "../data/use-favorites.js"
 import { StatusBar } from "./status-bar.js"
 import { HelpOverlay } from "./help-overlay.js"
 import { HomeView } from "../views/home.js"
@@ -38,6 +39,7 @@ export function Layout() {
   // Load agent + skill data on mount
   useDetectedAgents()
   useInstalledSkills()
+  useFavorites()
 
   // Global keyboard shortcuts
   useKeyboard((key) => {

package/src/components/skill-list-item.tsx

@@ -4,13 +4,14 @@ import { colors, agentBadges as badgeMap } from "../utils/colors.js"
 interface SkillListItemProps {
   skill: EnrichedSkill
   selected?: boolean
+  favorited?: boolean
 }
 
 /**
  * Compact skill list item for the middle panel.
  * Shows just the name and small agent dot indicators.
  */
-export function SkillListItem({ skill, selected }: SkillListItemProps) {
+export function SkillListItem({ skill, selected, favorited }: SkillListItemProps) {
   // Build compact agent dots (single-char badges)
   const agentDots = skill.agents.slice(0, 3).map((a) => {
     const badge = badgeMap[a]
@@ -27,6 +28,11 @@ export function SkillListItem({ skill, selected }: SkillListItemProps) {
         backgroundColor: selected ? colors.bgAlt : "transparent",
       }}
     >
+      {/* Star indicator (favorited skills only) */}
+      <text fg={favorited ? colors.warning : colors.textDim}>
+        {favorited ? "★ " : "  "}
+      </text>
+
       {/* Skill name */}
       <text fg={selected ? colors.primary : colors.text} style={{ flexGrow: 1 }}>
         {skill.name}

package/src/components/skill-list.tsx

@@ -1,7 +1,8 @@
-import { useState, useEffect } from "react"
+import { useState, useEffect, useMemo } from "react"
 import { useKeyboard } from "@opentui/react"
 import { useStore, useDispatch } from "../store/context.js"
 import { useSkillActions } from "../data/use-skill-actions.js"
+import { useFavorites } from "../data/use-favorites.js"
 import { SkillListItem } from "./skill-list-item.js"
 import { ConfirmDialog } from "./confirm-dialog.js"
 import { colors, agentBadges as badgeMap } from "../utils/colors.js"
@@ -30,6 +31,8 @@ export function SkillList({ skills }: SkillListProps) {
   const dispatch = useDispatch()
   const state = useStore()
   const { removeSkill, removeSkillFromOneAgent, updateSkill } = useSkillActions()
+  const { favorites, toggleFavorite } = useFavorites()
+  const favoritesSet = useMemo(() => new Set(favorites), [favorites])
   const [selectedIndex, setSelectedIndex] = useState(0)
   const [pendingAction, setPendingAction] = useState<PendingAction>(null)
   const [removeMode, setRemoveMode] = useState<RemoveMode>(null)
@@ -114,6 +117,21 @@ export function SkillList({ skills }: SkillListProps) {
     if (key.name === "u" && skills[selectedIndex]) {
       setPendingAction({ type: "update", skill: skills[selectedIndex] })
     }
+
+    // f to toggle favorite for selected skill
+    if (key.name === "f" && skills[selectedIndex]) {
+      const skill = skills[selectedIndex]
+      const isFavoritedAfter = toggleFavorite(skill.name)
+      dispatch({
+        type: "SHOW_NOTIFICATION",
+        notification: {
+          type: "info",
+          message: isFavoritedAfter
+            ? `Added "${skill.name}" to favorites`
+            : `Removed "${skill.name}" from favorites`,
+        },
+      })
+    }
   })
 
   // Handle confirm/cancel for pending actions
@@ -201,7 +219,9 @@ export function SkillList({ skills }: SkillListProps) {
         <text fg={colors.textDim}>
           {state.installedLoading
             ? "Scanning for installed skills..."
-            : "No skills found. Install skills with: skillsgate install <source>"}
+            : state.selectedAgentFilter === "favorites"
+              ? "No favorites yet. Press f on any skill to save it here."
+              : "No skills found. Install skills with: skillsgate install <source>"}
         </text>
       </box>
     )
@@ -237,6 +257,7 @@ export function SkillList({ skills }: SkillListProps) {
             key={skill.name}
             skill={skill}
             selected={i === selectedIndex}
+            favorited={favoritesSet.has(skill.name)}
           />
         ))}
       </scrollbox>

package/src/data/use-favorites.ts

@@ -0,0 +1,31 @@
+import { useCallback, useEffect } from "react"
+import { useDispatch, useStore } from "../store/context.js"
+import { useDb } from "../db/context.js"
+
+/**
+ * Hydrates the favorites list from the local DB on mount and exposes a
+ * `toggleFavorite` callback that updates both DB and store state.
+ */
+export function useFavorites() {
+  const dispatch = useDispatch()
+  const state = useStore()
+  const { favorites } = useDb()
+
+  useEffect(() => {
+    dispatch({ type: "SET_FAVORITES", favorites: favorites.list() })
+  }, [])
+
+  const toggleFavorite = useCallback(
+    (name: string): boolean => {
+      const next = favorites.toggle(name)
+      dispatch({ type: "SET_FAVORITES", favorites: favorites.list() })
+      return next
+    },
+    [favorites, dispatch],
+  )
+
+  return {
+    favorites: state.favorites,
+    toggleFavorite,
+  }
+}

package/src/db/context.tsx

@@ -3,12 +3,14 @@ import type { Database } from "bun:sqlite"
 import { SettingsStore } from "./settings.js"
 import { RemoteServerStore } from "./servers.js"
 import { RemoteSkillStore } from "./skills.js"
+import { FavoritesStore } from "./favorites.js"
 
 export interface DbContext {
   db: Database
   settings: SettingsStore
   servers: RemoteServerStore
   skills: RemoteSkillStore
+  favorites: FavoritesStore
 }
 
 const DbCtx = createContext<DbContext | null>(null)
@@ -24,6 +26,7 @@ export function DbProvider({ db, children }: DbProviderProps) {
     settings: new SettingsStore(db),
     servers: new RemoteServerStore(db),
     skills: new RemoteSkillStore(db),
+    favorites: new FavoritesStore(db),
   }
 
   return <DbCtx.Provider value={ctx}>{children}</DbCtx.Provider>

package/src/db/favorites.ts

@@ -0,0 +1,39 @@
+import type { Database } from "bun:sqlite"
+
+export class FavoritesStore {
+  private db: Database
+
+  constructor(db: Database) {
+    this.db = db
+  }
+
+  list(): string[] {
+    const rows = this.db
+      .query("SELECT skill_name FROM favorites ORDER BY created_at DESC")
+      .all() as Array<{ skill_name: string }>
+    return rows.map((r) => r.skill_name)
+  }
+
+  has(name: string): boolean {
+    const row = this.db
+      .query("SELECT 1 FROM favorites WHERE skill_name = ?")
+      .get(name)
+    return row !== null
+  }
+
+  toggle(name: string): boolean {
+    if (this.has(name)) {
+      this.db.query("DELETE FROM favorites WHERE skill_name = ?").run(name)
+      return false
+    }
+    this.db.query("INSERT INTO favorites (skill_name) VALUES (?)").run(name)
+    return true
+  }
+
+  count(): number {
+    const row = this.db
+      .query("SELECT COUNT(*) as c FROM favorites")
+      .get() as { c: number }
+    return row.c
+  }
+}

package/src/db/migrations.ts

@@ -70,6 +70,17 @@ const MIGRATIONS: Migration[] = [
       INSERT OR IGNORE INTO schema_version VALUES (2);
     `,
   },
+  {
+    version: 3,
+    up: `
+      CREATE TABLE IF NOT EXISTS favorites (
+        skill_name TEXT PRIMARY KEY,
+        created_at TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+
+      INSERT OR IGNORE INTO schema_version VALUES (3);
+    `,
+  },
 ]
 
 function getCurrentVersion(db: Database): number {

package/src/store/reducers.ts

@@ -10,6 +10,7 @@ export const initialState: AppState = {
   installedSkills: [],
   installedLoading: true,
   installedFilter: "",
+  favorites: [],
   searchQuery: "",
   searchResults: [],
   searchLoading: false,
@@ -61,6 +62,9 @@ export function appReducer(state: AppState, action: Action): AppState {
     case "SET_INSTALLED_FILTER":
       return { ...state, installedFilter: action.filter }
 
+    case "SET_FAVORITES":
+      return { ...state, favorites: action.favorites }
+
     case "SET_SEARCH_QUERY":
       return { ...state, searchQuery: action.query }
 

package/src/store/types.ts

@@ -63,11 +63,14 @@ export interface AppState {
   detectedAgents: DetectedAgent[]
 
   // Installed skills (home view)
-  selectedAgentFilter: string // agent name or "all"
+  selectedAgentFilter: string // agent name, "all", or "favorites"
   installedSkills: EnrichedSkill[]
   installedLoading: boolean
   installedFilter: string
 
+  // Favorites (skill names)
+  favorites: string[]
+
   // Search / discover
   searchQuery: string
   searchResults: unknown[]
@@ -98,6 +101,7 @@ export type Action =
   | { type: "SET_INSTALLED_SKILLS"; skills: EnrichedSkill[] }
   | { type: "SET_INSTALLED_LOADING"; loading: boolean }
   | { type: "SET_INSTALLED_FILTER"; filter: string }
+  | { type: "SET_FAVORITES"; favorites: string[] }
   | { type: "SET_SEARCH_QUERY"; query: string }
   | { type: "SET_SEARCH_RESULTS"; results: unknown[] }
   | { type: "SET_SEARCH_LOADING"; loading: boolean }

package/src/views/home.tsx

@@ -73,8 +73,11 @@ export function HomeView() {
       skills = skills.filter((skill) => ids.has(skill.canonicalPath))
     }
 
-    // Agent filter
-    if (state.selectedAgentFilter !== "all") {
+    // Agent filter (or favorites)
+    if (state.selectedAgentFilter === "favorites") {
+      const favSet = new Set(state.favorites)
+      skills = skills.filter((s) => favSet.has(s.name))
+    } else if (state.selectedAgentFilter !== "all") {
       skills = skills.filter((s) =>
         s.agents.includes(state.selectedAgentFilter as any)
       )
@@ -96,7 +99,7 @@ export function HomeView() {
     }
 
     return skills
-  }, [state.installedSkills, state.selectedAgentFilter, state.installedFilter, selectedCollection, collections, collectionsVersion])
+  }, [state.installedSkills, state.selectedAgentFilter, state.installedFilter, state.favorites, selectedCollection, collections, collectionsVersion])
 
   useKeyboard((key) => {
     if (state.activeView !== "home") return
@@ -383,7 +386,7 @@ function DetailPanel({ skill, collections, selectedCollection }: DetailPanelProp
         <text>{" "}</text>
 
         {/* Shortcut hints */}
-        <text fg={colors.textDim}>v=view detail  d=remove  u=update  n=create skill  c=collections  Tab=switch pane</text>
+        <text fg={colors.textDim}>v=view detail  d=remove  u=update  f=favorite  n=create skill  c=collections  Tab=switch pane</text>
         <text fg={colors.border}>---</text>
 
         {/* SKILL.md content */}