Update git commands extensions

extensions/git-commands/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Git Commands Changelog
 
+## [Beginner-friendly descriptions and keywords] - {{DATE}}
+
+- Rewrite alias descriptions for beginners with examples, pitfalls, and why.
+- Add search keywords for every alias to improve matching.
+
 ## [Maintenance] - 2026-01-01
 
 - Add copy and paste command to the action panel.

extensions/git-commands/README.md

@@ -5,7 +5,7 @@
 <h1 align="center">Git Commands</h1>
 
 <h3 align="center">
-Quickly use and learn Git commands and Oh My Zsh alias.
+Quickly use and learn Git commands and Oh My Zsh aliases.
 </h3>
 
 <p align="center">

extensions/git-commands/package.json

@@ -2,11 +2,12 @@
   "$schema": "https://www.raycast.com/schemas/extension.json",
   "name": "git-commands",
   "title": "Git Commands",
-  "description": "Quickly use and learn Git commands and Oh My Zsh alias.",
+  "description": "Quickly use and learn Git commands and Oh My Zsh aliases.",
   "icon": "icon.png",
   "author": "manumorante",
   "contributors": [
-    "ridemountainpig"
+    "ridemountainpig",
+    "chizitere_david"
   ],
   "categories": [
     "Documentation",

extensions/git-commands/src/search-commands.tsx

@@ -11,13 +11,15 @@ import {
   openCommandPreferences,
 } from "@raycast/api";
 import { useCachedPromise, useCachedState } from "@raycast/utils";
+import { useMemo, useState } from "react";
 import { Alias, Data } from "./types";
 import aliasesJSON from "./alias.json";
 
 const cache = new Cache();
 
 export default function Command() {
   const [showDetails, setShowDetails] = useCachedState("show-details", false);
+  const [searchText, setSearchText] = useState("");
 
   // Preferences
   const preferences = getPreferenceValues();
@@ -88,6 +90,42 @@ export default function Command() {
 
     return [...new Set([clean, clean.replace(/--/g, "")])];
   };
+
+  const normalize = (value: string) => value.toLowerCase().trim();
+  const tokenize = (value: string) => normalize(value).split(/\s+/).filter(Boolean);
+  const scoreAlias = (alias: Alias, query: string) => {
+    if (!query) return 0;
+    const terms = tokenize(query);
+    if (terms.length === 0) return 0;
+
+    const name = normalize(alias.name);
+    const command = normalize(alias.command);
+    const description = normalize(alias.description || "");
+    const keywords = (alias.keywords || []).map(normalize);
+
+    let score = 0;
+    for (const term of terms) {
+      if (name === term) score += 60;
+      if (name.startsWith(term)) score += 25;
+      if (command.startsWith(`git ${term}`)) score += 40;
+      if (command.includes(` ${term}`)) score += 10;
+      if (keywords.includes(term)) score += 20;
+      if (description.includes(term)) score += 5;
+    }
+    // Prefer shorter aliases (base commands) when scores are close.
+    score += Math.max(0, 10 - name.length);
+    return score;
+  };
+
+  const sortBySearch = (aliases: Alias[]) => {
+    if (!searchText.trim()) return aliases;
+    const query = searchText;
+    return aliases.slice().sort((a, b) => scoreAlias(b, query) - scoreAlias(a, query) || a.name.localeCompare(b.name));
+  };
+
+  const sortedPins = useMemo(() => sortBySearch(data.pins), [data.pins, searchText]);
+  const sortedRecent = useMemo(() => sortBySearch(data.recent), [data.recent, searchText]);
+  const sortedAliases = useMemo(() => sortBySearch(data.aliases), [data.aliases, searchText]);
   const Item = ({ alias, hidePin }: { alias: Alias; hidePin?: boolean }) => {
     const { name, command, type, description, pin = false, recent = false } = alias;
 
@@ -104,7 +142,12 @@ export default function Command() {
         title={name}
         subtitle={{ value: command, tooltip: command }}
         detail={<List.Item.Detail markdown={detail} />}
-        keywords={[...description.split(" "), ...command.split(" ").map(toKeyword).flat()]}
+        keywords={[
+          ...(alias.keywords || []),
+          ...description.split(" "),
+          ...command.split(" ").map(toKeyword).flat(),
+          name,
+        ]}
         accessories={[
           ...(pin && !hidePin
             ? [{ icon: { source: Icon.Tack, ...(isPinColored && { tintColor: Color.Yellow }) } }]
@@ -167,21 +210,22 @@ export default function Command() {
       isLoading={isLoading}
       searchBarPlaceholder="Search command, description or alias"
       isShowingDetail={showDetails}
+      onSearchTextChange={setSearchText}
     >
       <List.Section title="Pinned" subtitle={data.pins.length > maxPins ? `${data.pins.length}` : ""}>
-        {data.pins.slice(0, maxPins).map((alias) => (
+        {sortedPins.slice(0, maxPins).map((alias) => (
           <Item key={alias.name} alias={alias} hidePin />
         ))}
       </List.Section>
 
       <List.Section title="Recent" subtitle={data.recent.length > maxRecent ? `${data.recent.length}` : ""}>
-        {data.recent.slice(0, maxRecent).map((alias) => (
+        {sortedRecent.slice(0, maxRecent).map((alias) => (
           <Item key={alias.name} alias={alias} />
         ))}
       </List.Section>
 
       <List.Section title="All aliases" subtitle={`${data.aliases.length}`}>
-        {data.aliases.map((alias) => (
+        {sortedAliases.map((alias) => (
           <Item key={alias.name} alias={alias} />
         ))}
       </List.Section>

extensions/git-commands/src/types.d.ts

@@ -7,6 +7,7 @@ export type Alias = {
   description: string;
   pin?: boolean;
   recent?: boolean;
+  keywords?: string[];
 };
 
 /**