claudeup 4.17.0 → 4.18.0

package/src/services/marketplace-fetcher.js

@@ -0,0 +1,96 @@
+/**
+ * Marketplace.json fetcher with offline fallback.
+ *
+ * Extracted from `plugin-manager.ts` so the fetch + fallback logic can be
+ * unit-tested without dragging in claude-settings.ts's module-level
+ * `os.homedir()` constants (which contaminate the test suite when
+ * imported via plugin-manager.ts).
+ */
+import { isValidGitHubRepo } from "../utils/string-utils.js";
+// Session-level cache for fetched marketplace data (no TTL - persists until explicit refresh)
+const marketplaceCache = new Map();
+export function clearMarketplaceCache() {
+    marketplaceCache.clear();
+}
+export async function fetchMarketplacePlugins(marketplaceName, repo) {
+    // Check cache first - session-level, no TTL
+    const cached = marketplaceCache.get(marketplaceName);
+    if (cached) {
+        return cached;
+    }
+    // Validate repo format to prevent SSRF
+    if (!isValidGitHubRepo(repo)) {
+        console.error(`Invalid GitHub repo format: ${repo}`);
+        return [];
+    }
+    try {
+        // Fetch marketplace.json from GitHub
+        const url = `https://raw.githubusercontent.com/${repo}/main/.claude-plugin/marketplace.json`;
+        const response = await fetch(url, {
+            signal: AbortSignal.timeout(10000), // 10s timeout
+        });
+        if (!response.ok) {
+            console.error(`Failed to fetch marketplace: ${response.status}`);
+            return [];
+        }
+        // Validate content-type
+        const contentType = response.headers.get("content-type");
+        if (contentType &&
+            !contentType.includes("application/json") &&
+            !contentType.includes("text/plain")) {
+            console.error(`Invalid content-type for marketplace: ${contentType}`);
+            return [];
+        }
+        const data = (await response.json());
+        const plugins = [];
+        if (data.plugins && Array.isArray(data.plugins)) {
+            for (const plugin of data.plugins) {
+                plugins.push({
+                    name: plugin.name,
+                    version: plugin.version || null,
+                    description: plugin.description || "",
+                    category: plugin.category,
+                    author: plugin.author,
+                    homepage: plugin.homepage,
+                    tags: plugin.tags,
+                });
+            }
+        }
+        // Cache the result (session-level)
+        marketplaceCache.set(marketplaceName, plugins);
+        return plugins;
+    }
+    catch (error) {
+        console.error(`Error fetching marketplace ${marketplaceName}:`, error);
+        return [];
+    }
+}
+/**
+ * Resolve marketplace plugins with offline fallback.
+ *
+ * Calls `fetchMarketplacePlugins` (which hits GitHub) and, when it returns
+ * empty AND a local marketplace cache exists for the same name, falls back
+ * to the cached plugin manifest. This prevents every installed plugin from
+ * being flagged `isOrphaned: true` (and rendered "deprecated") whenever the
+ * machine can't reach `raw.githubusercontent.com` — the local cache already
+ * has the data, it just wasn't being consulted as a fallback.
+ *
+ * The two shapes are nearly identical; we drop a couple of LocalMarketplacePlugin
+ * fields (lspServers, agents, etc.) that MarketplacePlugin doesn't carry
+ * since the caller doesn't read them at this layer.
+ */
+export async function resolveMarketplacePlugins(mpName, repo, localMarketplaces) {
+    const remote = await fetchMarketplacePlugins(mpName, repo);
+    if (remote.length > 0)
+        return remote;
+    const local = localMarketplaces.get(mpName);
+    if (!local || local.plugins.length === 0)
+        return remote;
+    return local.plugins.map((p) => ({
+        name: p.name,
+        version: p.version,
+        description: p.description,
+        category: p.category,
+        author: p.author,
+    }));
+}

package/src/services/marketplace-fetcher.ts

@@ -0,0 +1,137 @@
+/**
+ * Marketplace.json fetcher with offline fallback.
+ *
+ * Extracted from `plugin-manager.ts` so the fetch + fallback logic can be
+ * unit-tested without dragging in claude-settings.ts's module-level
+ * `os.homedir()` constants (which contaminate the test suite when
+ * imported via plugin-manager.ts).
+ */
+
+import { isValidGitHubRepo } from "../utils/string-utils.js";
+import type { LocalMarketplace } from "./local-marketplace.js";
+
+export interface MarketplacePlugin {
+  name: string;
+  version: string | null;
+  description: string;
+  category?: string;
+  author?: { name: string; email?: string };
+  homepage?: string;
+  tags?: string[];
+}
+
+// Session-level cache for fetched marketplace data (no TTL - persists until explicit refresh)
+const marketplaceCache = new Map<string, MarketplacePlugin[]>();
+
+export function clearMarketplaceCache(): void {
+  marketplaceCache.clear();
+}
+
+export async function fetchMarketplacePlugins(
+  marketplaceName: string,
+  repo: string,
+): Promise<MarketplacePlugin[]> {
+  // Check cache first - session-level, no TTL
+  const cached = marketplaceCache.get(marketplaceName);
+  if (cached) {
+    return cached;
+  }
+
+  // Validate repo format to prevent SSRF
+  if (!isValidGitHubRepo(repo)) {
+    console.error(`Invalid GitHub repo format: ${repo}`);
+    return [];
+  }
+
+  try {
+    // Fetch marketplace.json from GitHub
+    const url = `https://raw.githubusercontent.com/${repo}/main/.claude-plugin/marketplace.json`;
+    const response = await fetch(url, {
+      signal: AbortSignal.timeout(10000), // 10s timeout
+    });
+
+    if (!response.ok) {
+      console.error(`Failed to fetch marketplace: ${response.status}`);
+      return [];
+    }
+
+    // Validate content-type
+    const contentType = response.headers.get("content-type");
+    if (
+      contentType &&
+      !contentType.includes("application/json") &&
+      !contentType.includes("text/plain")
+    ) {
+      console.error(`Invalid content-type for marketplace: ${contentType}`);
+      return [];
+    }
+
+    interface RawPlugin {
+      name: string;
+      version?: string | null;
+      description?: string;
+      category?: string;
+      author?: { name: string; email?: string };
+      homepage?: string;
+      tags?: string[];
+    }
+    const data = (await response.json()) as { plugins?: RawPlugin[] };
+    const plugins: MarketplacePlugin[] = [];
+
+    if (data.plugins && Array.isArray(data.plugins)) {
+      for (const plugin of data.plugins) {
+        plugins.push({
+          name: plugin.name,
+          version: plugin.version || null,
+          description: plugin.description || "",
+          category: plugin.category,
+          author: plugin.author,
+          homepage: plugin.homepage,
+          tags: plugin.tags,
+        });
+      }
+    }
+
+    // Cache the result (session-level)
+    marketplaceCache.set(marketplaceName, plugins);
+
+    return plugins;
+  } catch (error) {
+    console.error(`Error fetching marketplace ${marketplaceName}:`, error);
+    return [];
+  }
+}
+
+/**
+ * Resolve marketplace plugins with offline fallback.
+ *
+ * Calls `fetchMarketplacePlugins` (which hits GitHub) and, when it returns
+ * empty AND a local marketplace cache exists for the same name, falls back
+ * to the cached plugin manifest. This prevents every installed plugin from
+ * being flagged `isOrphaned: true` (and rendered "deprecated") whenever the
+ * machine can't reach `raw.githubusercontent.com` — the local cache already
+ * has the data, it just wasn't being consulted as a fallback.
+ *
+ * The two shapes are nearly identical; we drop a couple of LocalMarketplacePlugin
+ * fields (lspServers, agents, etc.) that MarketplacePlugin doesn't carry
+ * since the caller doesn't read them at this layer.
+ */
+export async function resolveMarketplacePlugins(
+  mpName: string,
+  repo: string,
+  localMarketplaces: Map<string, LocalMarketplace>,
+): Promise<MarketplacePlugin[]> {
+  const remote = await fetchMarketplacePlugins(mpName, repo);
+  if (remote.length > 0) return remote;
+
+  const local = localMarketplaces.get(mpName);
+  if (!local || local.plugins.length === 0) return remote;
+
+  return local.plugins.map((p) => ({
+    name: p.name,
+    version: p.version,
+    description: p.description,
+    category: p.category,
+    author: p.author,
+  }));
+}

package/src/services/plugin-manager.js

@@ -4,64 +4,11 @@ import { execSync } from "node:child_process";
 import { getConfiguredMarketplaces, getEnabledPlugins, readSettings, writeSettings, getGlobalConfiguredMarketplaces, getGlobalEnabledPlugins, getGlobalInstalledPluginVersions, getLocalEnabledPlugins, getLocalInstalledPluginVersions, updateInstalledPluginsRegistry, removeFromInstalledPluginsRegistry, } from "./claude-settings.js";
 import { defaultMarketplaces } from "../data/marketplaces.js";
 import { scanLocalMarketplaces, repairAllMarketplaces, } from "./local-marketplace.js";
-import { formatMarketplaceName, isValidGitHubRepo, parsePluginId, } from "../utils/string-utils.js";
+import { formatMarketplaceName, parsePluginId, } from "../utils/string-utils.js";
+import { clearMarketplaceCache as clearFetcherCache, fetchMarketplacePlugins, resolveMarketplacePlugins, } from "./marketplace-fetcher.js";
+export { fetchMarketplacePlugins, resolveMarketplacePlugins, };
 // Cache for local marketplaces (session-level) - Promise-based to prevent race conditions
 let localMarketplacesPromise = null;
-// Session-level cache for fetched marketplace data (no TTL - persists until explicit refresh)
-const marketplaceCache = new Map();
-export async function fetchMarketplacePlugins(marketplaceName, repo) {
-    // Check cache first - session-level, no TTL
-    const cached = marketplaceCache.get(marketplaceName);
-    if (cached) {
-        return cached;
-    }
-    // Validate repo format to prevent SSRF
-    if (!isValidGitHubRepo(repo)) {
-        console.error(`Invalid GitHub repo format: ${repo}`);
-        return [];
-    }
-    try {
-        // Fetch marketplace.json from GitHub
-        const url = `https://raw.githubusercontent.com/${repo}/main/.claude-plugin/marketplace.json`;
-        const response = await fetch(url, {
-            signal: AbortSignal.timeout(10000), // 10s timeout
-        });
-        if (!response.ok) {
-            console.error(`Failed to fetch marketplace: ${response.status}`);
-            return [];
-        }
-        // Validate content-type
-        const contentType = response.headers.get("content-type");
-        if (contentType &&
-            !contentType.includes("application/json") &&
-            !contentType.includes("text/plain")) {
-            console.error(`Invalid content-type for marketplace: ${contentType}`);
-            return [];
-        }
-        const data = (await response.json());
-        const plugins = [];
-        if (data.plugins && Array.isArray(data.plugins)) {
-            for (const plugin of data.plugins) {
-                plugins.push({
-                    name: plugin.name,
-                    version: plugin.version || null,
-                    description: plugin.description || "",
-                    category: plugin.category,
-                    author: plugin.author,
-                    homepage: plugin.homepage,
-                    tags: plugin.tags,
-                });
-            }
-        }
-        // Cache the result (session-level)
-        marketplaceCache.set(marketplaceName, plugins);
-        return plugins;
-    }
-    catch (error) {
-        console.error(`Error fetching marketplace ${marketplaceName}:`, error);
-        return [];
-    }
-}
 export async function getAvailablePlugins(projectPath) {
     const configuredMarketplaces = await getConfiguredMarketplaces(projectPath);
     const enabledPlugins = await getEnabledPlugins(projectPath);
@@ -111,7 +58,7 @@ export async function getAvailablePlugins(projectPath) {
         const marketplace = defaultMarketplaces.find((m) => m.name === mpName);
         if (!marketplace)
             continue;
-        const marketplacePlugins = await fetchMarketplacePlugins(mpName, marketplace.source.repo);
+        const marketplacePlugins = await resolveMarketplacePlugins(mpName, marketplace.source.repo, localMarketplaces);
         // Auto-sync local cache if remote has plugins the local cache doesn't
         localMarketplaces = await autoSyncIfStale(mpName, marketplacePlugins.map((p) => p.name), localMarketplaces);
         for (const plugin of marketplacePlugins) {
@@ -265,7 +212,7 @@ export async function getGlobalAvailablePlugins() {
         const marketplace = defaultMarketplaces.find((m) => m.name === mpName);
         if (!marketplace)
             continue;
-        const marketplacePlugins = await fetchMarketplacePlugins(mpName, marketplace.source.repo);
+        const marketplacePlugins = await resolveMarketplacePlugins(mpName, marketplace.source.repo, localMarketplaces);
         // Auto-sync local cache if remote has plugins the local cache doesn't
         localMarketplaces = await autoSyncIfStale(mpName, marketplacePlugins.map((p) => p.name), localMarketplaces);
         for (const plugin of marketplacePlugins) {
@@ -414,7 +361,7 @@ export async function removeInstalledPluginVersion(pluginId, projectPath) {
 }
 // Clear marketplace cache
 export function clearMarketplaceCache() {
-    marketplaceCache.clear();
+    clearFetcherCache();
     localMarketplacesPromise = null;
 }
 // Get local marketplaces (with Promise-based caching to prevent race conditions)

package/src/services/plugin-manager.ts

@@ -24,9 +24,19 @@ import {
 } from "./local-marketplace.js";
 import {
 	formatMarketplaceName,
-	isValidGitHubRepo,
 	parsePluginId,
 } from "../utils/string-utils.js";
+import {
+	clearMarketplaceCache as clearFetcherCache,
+	fetchMarketplacePlugins,
+	resolveMarketplacePlugins,
+	type MarketplacePlugin,
+} from "./marketplace-fetcher.js";
+export {
+	fetchMarketplacePlugins,
+	resolveMarketplacePlugins,
+	type MarketplacePlugin,
+};
 // Cache for local marketplaces (session-level) - Promise-based to prevent race conditions
 let localMarketplacesPromise: Promise<Map<string, LocalMarketplace>> | null =
 	null;
@@ -63,93 +73,6 @@ export interface PluginInfo {
 	isOrphaned?: boolean;
 }
 
-export interface MarketplacePlugin {
-	name: string;
-	version: string | null;
-	description: string;
-	category?: string;
-	author?: { name: string; email?: string };
-	homepage?: string;
-	tags?: string[];
-}
-
-// Session-level cache for fetched marketplace data (no TTL - persists until explicit refresh)
-const marketplaceCache = new Map<string, MarketplacePlugin[]>();
-
-export async function fetchMarketplacePlugins(
-	marketplaceName: string,
-	repo: string,
-): Promise<MarketplacePlugin[]> {
-	// Check cache first - session-level, no TTL
-	const cached = marketplaceCache.get(marketplaceName);
-	if (cached) {
-		return cached;
-	}
-
-	// Validate repo format to prevent SSRF
-	if (!isValidGitHubRepo(repo)) {
-		console.error(`Invalid GitHub repo format: ${repo}`);
-		return [];
-	}
-
-	try {
-		// Fetch marketplace.json from GitHub
-		const url = `https://raw.githubusercontent.com/${repo}/main/.claude-plugin/marketplace.json`;
-		const response = await fetch(url, {
-			signal: AbortSignal.timeout(10000), // 10s timeout
-		});
-
-		if (!response.ok) {
-			console.error(`Failed to fetch marketplace: ${response.status}`);
-			return [];
-		}
-
-		// Validate content-type
-		const contentType = response.headers.get("content-type");
-		if (
-			contentType &&
-			!contentType.includes("application/json") &&
-			!contentType.includes("text/plain")
-		) {
-			console.error(`Invalid content-type for marketplace: ${contentType}`);
-			return [];
-		}
-
-		interface RawPlugin {
-			name: string;
-			version?: string | null;
-			description?: string;
-			category?: string;
-			author?: { name: string; email?: string };
-			homepage?: string;
-			tags?: string[];
-		}
-		const data = (await response.json()) as { plugins?: RawPlugin[] };
-		const plugins: MarketplacePlugin[] = [];
-
-		if (data.plugins && Array.isArray(data.plugins)) {
-			for (const plugin of data.plugins) {
-				plugins.push({
-					name: plugin.name,
-					version: plugin.version || null,
-					description: plugin.description || "",
-					category: plugin.category,
-					author: plugin.author,
-					homepage: plugin.homepage,
-					tags: plugin.tags,
-				});
-			}
-		}
-
-		// Cache the result (session-level)
-		marketplaceCache.set(marketplaceName, plugins);
-
-		return plugins;
-	} catch (error) {
-		console.error(`Error fetching marketplace ${marketplaceName}:`, error);
-		return [];
-	}
-}
 
 export async function getAvailablePlugins(
 	projectPath?: string,
@@ -213,9 +136,10 @@ export async function getAvailablePlugins(
 		const marketplace = defaultMarketplaces.find((m) => m.name === mpName);
 		if (!marketplace) continue;
 
-		const marketplacePlugins = await fetchMarketplacePlugins(
+		const marketplacePlugins = await resolveMarketplacePlugins(
 			mpName,
 			marketplace.source.repo,
+			localMarketplaces,
 		);
 
 		// Auto-sync local cache if remote has plugins the local cache doesn't
@@ -397,9 +321,10 @@ export async function getGlobalAvailablePlugins(): Promise<PluginInfo[]> {
 		const marketplace = defaultMarketplaces.find((m) => m.name === mpName);
 		if (!marketplace) continue;
 
-		const marketplacePlugins = await fetchMarketplacePlugins(
+		const marketplacePlugins = await resolveMarketplacePlugins(
 			mpName,
 			marketplace.source.repo,
+			localMarketplaces,
 		);
 
 		// Auto-sync local cache if remote has plugins the local cache doesn't
@@ -592,7 +517,7 @@ export async function removeInstalledPluginVersion(
 
 // Clear marketplace cache
 export function clearMarketplaceCache(): void {
-	marketplaceCache.clear();
+	clearFetcherCache();
 	localMarketplacesPromise = null;
 }
 

package/src/services/skillsmp-client.js

@@ -7,10 +7,28 @@
  * - GitHub Tree API with ETag caching
  * - Recommended skills list
  */
-// TODO: Update to production URL after Firebase deploy
+// Deployed `skills` Gen2 Cloud Function (project claudish-6da10, us-central1).
+// Firebase keeps this cloudfunctions.net alias stable for the function.
 const SKILLS_API_BASE = process.env.SKILLS_API_URL || "https://us-central1-claudish-6da10.cloudfunctions.net/skills";
 /**
- * Search skills across all sources (SkillsMP keyword + AI search)
+ * Thrown when the skills API is unreachable or returns a non-OK status.
+ * Lets callers distinguish "search service is down" from "no skills matched",
+ * which a bare `[]` return cannot express.
+ */
+export class SkillsApiError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = "SkillsApiError";
+    }
+}
+/**
+ * Search skills across all sources (SkillsMP keyword + AI search).
+ *
+ * Throws {@link SkillsApiError} on transport/HTTP failure so the caller can
+ * surface a distinct "search unavailable" state. An empty array means the
+ * query genuinely matched nothing.
  */
 export async function searchSkills(query, options) {
     const params = new URLSearchParams({ q: query });
@@ -18,18 +36,20 @@ export async function searchSkills(query, options) {
         params.set("page", String(options.page));
     if (options?.limit)
         params.set("limit", String(options.limit));
+    let res;
     try {
-        const res = await fetch(`${SKILLS_API_BASE}/search?${params}`, {
+        res = await fetch(`${SKILLS_API_BASE}/search?${params}`, {
             signal: AbortSignal.timeout(12000),
         });
-        if (!res.ok)
-            return [];
-        const data = (await res.json());
-        return data.skills || [];
     }
-    catch {
-        return [];
+    catch (cause) {
+        throw new SkillsApiError(`Skills search request failed: ${cause instanceof Error ? cause.message : String(cause)}`);
+    }
+    if (!res.ok) {
+        throw new SkillsApiError(`Skills search returned HTTP ${res.status}`, res.status);
     }
+    const data = (await res.json());
+    return data.skills || [];
 }
 /**
  * Fetch skills from a specific GitHub repo (via our proxy)

package/src/services/skillsmp-client.ts

@@ -8,7 +8,8 @@
  * - Recommended skills list
  */
 
-// TODO: Update to production URL after Firebase deploy
+// Deployed `skills` Gen2 Cloud Function (project claudish-6da10, us-central1).
+// Firebase keeps this cloudfunctions.net alias stable for the function.
 const SKILLS_API_BASE =
 	process.env.SKILLS_API_URL || "https://us-central1-claudish-6da10.cloudfunctions.net/skills";
 
@@ -31,7 +32,26 @@ export interface RepoSkillResult {
 }
 
 /**
- * Search skills across all sources (SkillsMP keyword + AI search)
+ * Thrown when the skills API is unreachable or returns a non-OK status.
+ * Lets callers distinguish "search service is down" from "no skills matched",
+ * which a bare `[]` return cannot express.
+ */
+export class SkillsApiError extends Error {
+	constructor(
+		message: string,
+		readonly status?: number,
+	) {
+		super(message);
+		this.name = "SkillsApiError";
+	}
+}
+
+/**
+ * Search skills across all sources (SkillsMP keyword + AI search).
+ *
+ * Throws {@link SkillsApiError} on transport/HTTP failure so the caller can
+ * surface a distinct "search unavailable" state. An empty array means the
+ * query genuinely matched nothing.
  */
 export async function searchSkills(
 	query: string,
@@ -41,16 +61,26 @@ export async function searchSkills(
 	if (options?.page) params.set("page", String(options.page));
 	if (options?.limit) params.set("limit", String(options.limit));
 
+	let res: Response;
 	try {
-		const res = await fetch(`${SKILLS_API_BASE}/search?${params}`, {
+		res = await fetch(`${SKILLS_API_BASE}/search?${params}`, {
 			signal: AbortSignal.timeout(12000),
 		});
-		if (!res.ok) return [];
-		const data = (await res.json()) as { skills: SkillSearchResult[] };
-		return data.skills || [];
-	} catch {
-		return [];
+	} catch (cause) {
+		throw new SkillsApiError(
+			`Skills search request failed: ${cause instanceof Error ? cause.message : String(cause)}`,
+		);
 	}
+
+	if (!res.ok) {
+		throw new SkillsApiError(
+			`Skills search returned HTTP ${res.status}`,
+			res.status,
+		);
+	}
+
+	const data = (await res.json()) as { skills?: SkillSearchResult[] };
+	return data.skills || [];
 }
 
 /**

package/src/types/gitignore.ts

@@ -6,7 +6,7 @@
 
 export type RuleAction = "ignore" | "track";
 
-export type Tier = "builtin" | "global" | "project";
+export type Tier = "builtin" | "global" | "project" | "profile";
 
 /** A user-authored manifest, deserialized from JSON. */
 export interface GitignoreManifest {

package/src/ui/App.js

@@ -5,7 +5,7 @@ import fs from "node:fs";
 import { AppProvider, useApp, useNavigation, useModal, } from "./state/AppContext.js";
 import { DimensionsProvider, useDimensions, } from "./state/DimensionsContext.js";
 import { ModalContainer } from "./components/modals/index.js";
-import { PluginsScreen, McpScreen, McpRegistryScreen, SettingsScreen, CliToolsScreen, ModelSelectorScreen, ProfilesScreen, SkillsScreen, GitignoreScreen, } from "./screens/index.js";
+import { PluginsScreen, McpScreen, McpRegistryScreen, SettingsScreen, CliToolsScreen, ModelSelectorScreen, ProfilesScreen, SkillsScreen, GitignoreScreen, AliasScreen, } from "./screens/index.js";
 import { checkGitignore } from "../services/gitignore-prerun.js";
 import { loadGitignoreState, applyAllSafeFixes, } from "../services/gitignore-service.js";
 import { useGitignoreModal } from "./hooks/useGitignoreModal.js";
@@ -45,6 +45,8 @@ function Router() {
             return _jsx(SkillsScreen, {});
         case "gitignore":
             return _jsx(GitignoreScreen, {});
+        case "alias":
+            return _jsx(AliasScreen, {});
         default:
             return _jsx(PluginsScreen, {});
     }
@@ -86,7 +88,7 @@ function GlobalKeyHandler({ onDebugToggle, onExit, }) {
         // Don't handle keys when modal is open or searching
         if (state.modal || state.isSearching)
             return;
-        // Global navigation shortcuts (1-7) - include mcp-registry as it's a sub-screen of mcp
+        // Global navigation shortcuts (1-8) - include mcp-registry as it's a sub-screen of mcp
         const isTopLevel = [
             "plugins",
             "mcp",
@@ -97,6 +99,7 @@ function GlobalKeyHandler({ onDebugToggle, onExit, }) {
             "profiles",
             "skills",
             "gitignore",
+            "alias",
         ].includes(state.currentRoute.screen);
         if (isTopLevel) {
             if (input === "1")
@@ -113,6 +116,8 @@ function GlobalKeyHandler({ onDebugToggle, onExit, }) {
                 navigateToScreen("cli-tools");
             else if (input === "7")
                 navigateToScreen("gitignore");
+            else if (input === "8")
+                navigateToScreen("alias");
             // Tab navigation cycling
             if (key.tab) {
                 const screens = [
@@ -123,6 +128,7 @@ function GlobalKeyHandler({ onDebugToggle, onExit, }) {
                     "profiles",
                     "cli-tools",
                     "gitignore",
+                    "alias",
                 ];
                 const currentIndex = screens.indexOf(state.currentRoute.screen);
                 if (currentIndex !== -1) {
@@ -157,8 +163,8 @@ function GlobalKeyHandler({ onDebugToggle, onExit, }) {
   ?             This help
 
 Quick Navigation
-  1  Plugins      4  Settings    7  Gitignore
-  2  Skills       5  Profiles
+  1  Plugins      4  Settings    7  Git State
+  2  Skills       5  Profiles    8  Alias
   3  MCP Servers  6  CLI Tools
 
 Plugin Actions