gh-manager-cli 1.4.2 → 1.6.0

package/CHANGELOG.md

@@ -1,3 +1,24 @@
+# [1.6.0](https://github.com/wiiiimm/gh-manager-cli/compare/v1.5.0...v1.6.0) (2025-08-31)
+
+
+### Bug Fixes
+
+* make cache inspection visible in terminal ([2030466](https://github.com/wiiiimm/gh-manager-cli/commit/2030466e1b2bf377a22e07eba5a0334b9c3a6bc5))
+
+
+### Features
+
+* add Apollo cache debugging and verification tools ([e4828c4](https://github.com/wiiiimm/gh-manager-cli/commit/e4828c4463b6ebb58f419f6e6e17c06c699b31ac))
+* add cache testing scripts and environment template ([2b4d840](https://github.com/wiiiimm/gh-manager-cli/commit/2b4d840f0a32a4089c47bca9664ac393e824643a))
+* add repository info modal and always-on Apollo cache ([aecfd31](https://github.com/wiiiimm/gh-manager-cli/commit/aecfd311feaf5e674d2f8f15062f12d6deffcfe5))
+
+# [1.5.0](https://github.com/wiiiimm/gh-manager-cli/compare/v1.4.2...v1.5.0) (2025-08-31)
+
+
+### Features
+
+* add fork sync functionality and update documentation ([1d37a10](https://github.com/wiiiimm/gh-manager-cli/commit/1d37a10d90636731c436679b0a4ff2d1c3e1daae))
+
 ## [1.4.2](https://github.com/wiiiimm/gh-manager-cli/compare/v1.4.1...v1.4.2) (2025-08-31)
 
 

package/README.md

@@ -2,6 +2,27 @@
 
 Interactive terminal app to browse and manage your personal GitHub repositories. Built with Ink (React for CLIs) and the GitHub GraphQL API.
 
+## Screenshots
+
+<div align="center">
+
+### Repository Listing
+Browse your repositories with rich metadata, sorting, and filtering options.
+
+<img src="docs/demo_repo_listing.png" alt="Repository listing interface showing repositories with metadata" width="800">
+
+### Authentication Flow  
+Secure GitHub token authentication with validation and persistence.
+
+<img src="docs/demo_login.png" alt="Login screen prompting for GitHub token" width="800">
+
+### Delete Confirmation
+Safe repository deletion with two-step confirmation process.
+
+<img src="docs/demo_delete_confirmation.png" alt="Delete confirmation dialog with security prompts" width="800">
+
+</div>
+
 ## Quick Start
 
 ```bash
@@ -20,9 +41,11 @@ On first run, you'll be prompted for a GitHub Personal Access Token.
 - **Real-time Sorting**: Server-side sorting by updated, pushed, name, or stars (with direction toggle)
 - **Smart Filtering**: Client-side search through repository names and descriptions
 - **Repository Actions**:
+  - View detailed info (`I`) - Shows repository metadata, language, size, and timestamps
   - Open in browser (Enter/`O`)
   - Delete repository (`Del` or `Ctrl+Backspace`) with secure two-step confirmation
   - Archive/unarchive repositories (`Ctrl+A`) with confirmation prompts
+  - Sync forks with upstream (`Ctrl+U`) with automatic conflict detection
 
 ### User Interface & Experience
 - **Keyboard Navigation**: Full keyboard control (arrow keys, PageUp/Down, `Ctrl+G`/`G`)
@@ -117,6 +140,7 @@ Launch the app, then use the keys below:
 - Filter: `/` to enter, type query, Enter to apply (Esc cancels)
 - Sorting: `S` to cycle field (updated → pushed → name → stars → forks), `D` to toggle direction
 - Display density: `T` to toggle compact/cozy/comfy
+- Repository info: `I` to view detailed metadata (size, language, timestamps)
 - Open in browser: Enter or `O`
 - Delete repository: `Del` or `Ctrl+Backspace` (with confirmation modal)
   - Uses GitHub REST API (requires `delete_repo` scope and admin rights)
@@ -124,6 +148,7 @@ Launch the app, then use the keys below:
   - Confirm: press `Y` or Enter
   - Cancel: press `C` or Esc
 - Archive/Unarchive: `Ctrl+A`
+- Sync fork with upstream: `Ctrl+U` (for forks only, shows commit status and handles conflicts)
 - Logout: `Ctrl+L`
 - Toggle fork metrics: `F`
 - Quit: `Q`
@@ -166,6 +191,47 @@ Project layout:
 - `src/config.ts` — token read/write and file perms
 - `src/types.ts` — shared types
 
+## Apollo Cache (Performance)
+
+gh-manager-cli includes built-in Apollo Client caching to reduce GitHub API calls and improve performance. Caching is **always enabled** for optimal performance.
+
+### Verifying Cache is Working
+
+1. **Debug Output**: Run with `GH_MANAGER_DEBUG=1` to see cache status:
+   ```bash
+   GH_MANAGER_DEBUG=1 npx gh-manager
+   ```
+
+2. **Cache Inspection**: Press `i` (in debug mode) to inspect cache status:
+   - Shows cache file size and age
+   - Lists recent cache entries with timestamps
+   - Displays cache directory location
+
+3. **Performance Indicators**:
+   - **From cache: YES** = Data served from cache
+   - **Query time < 50ms** = Likely cache hit
+   - **API credits stable** = Fewer API calls being made
+
+### Why API Credits Might Still Decrease
+
+Even with caching enabled, API credits may decrease due to:
+
+- **First-time requests**: Initial data must be fetched and cached
+- **Cache expiration**: Default 30-minute TTL (customize with `APOLLO_TTL_MS`)
+- **Pagination**: New pages beyond the cache are fetched from API
+- **Cache-and-network policy**: Updates stale cache data in background
+- **Sorting changes**: Different sort orders create new cache entries
+
+### Cache Configuration
+
+```bash
+# Custom cache TTL (milliseconds) - default: 30 minutes
+APOLLO_TTL_MS=1800000 npx gh-manager
+
+# Enable debug mode to see cache performance
+GH_MANAGER_DEBUG=1 npx gh-manager
+```
+
 ## Troubleshooting
 
 - Invalid token: enter a valid PAT (recommended scope: `repo`).

package/dist/index.js

@@ -9,7 +9,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "gh-manager-cli",
-      version: "1.4.2",
+      version: "1.6.0",
       private: false,
       description: "Interactive CLI to manage your GitHub repos (personal) with Ink",
       license: "MIT",
@@ -38,13 +38,18 @@ var require_package = __commonJS({
         "build:binaries": "npm run build && pkg dist/index.js --targets node18-linux-x64,node18-macos-x64,node18-windows-x64 --out-path ./binaries",
         dev: "tsup --watch",
         start: "node dist/index.js",
+        "start:cache": "GH_MANAGER_APOLLO=1 GH_MANAGER_DEBUG=1 node dist/index.js",
+        "start:no-cache": "GH_MANAGER_APOLLO=0 GH_MANAGER_DEBUG=1 node dist/index.js",
+        "test:cache": "pnpm build && pnpm start:cache",
         prepublishOnly: "pnpm run build"
       },
       engines: {
         node: ">=18"
       },
       dependencies: {
+        "@apollo/client": "^3.11.10",
         "@octokit/graphql": "^9.0.1",
+        "apollo3-cache-persist": "^0.14.1",
         chalk: "^5.6.0",
         dotenv: "^17.2.1",
         "env-paths": "^3.0.0",
@@ -187,6 +192,63 @@ function makeClient(token) {
     headers: { authorization: `token ${token}` }
   });
 }
+async function makeApolloClient(token) {
+  const apollo = await import("@apollo/client/core");
+  const { persistCache } = await import("apollo3-cache-persist");
+  const { ApolloClient, InMemoryCache, HttpLink, gql } = apollo;
+  const cache = new InMemoryCache();
+  const storage = {
+    async getItem(key) {
+      try {
+        const fs3 = await import("fs");
+        const path3 = await import("path");
+        const envPaths3 = (await import("env-paths")).default;
+        const p = envPaths3("gh-manager-cli").data;
+        const file = path3.join(p, "apollo-cache.json");
+        return fs3.readFileSync(file, "utf8");
+      } catch {
+        return null;
+      }
+    },
+    async setItem(key, value) {
+      try {
+        const fs3 = await import("fs");
+        const path3 = await import("path");
+        const envPaths3 = (await import("env-paths")).default;
+        const p = envPaths3("gh-manager-cli").data;
+        fs3.mkdirSync(p, { recursive: true });
+        const file = path3.join(p, "apollo-cache.json");
+        fs3.writeFileSync(file, value, "utf8");
+        if (process.platform !== "win32") {
+          try {
+            fs3.chmodSync(file, 384);
+          } catch {
+          }
+        }
+      } catch {
+      }
+    },
+    async removeItem(key) {
+      try {
+        const fs3 = await import("fs");
+        const path3 = await import("path");
+        const envPaths3 = (await import("env-paths")).default;
+        const p = envPaths3("gh-manager-cli").data;
+        const file = path3.join(p, "apollo-cache.json");
+        fs3.unlinkSync(file);
+      } catch {
+      }
+    }
+  };
+  await persistCache({ cache, storage, debounce: 500, maxSize: 5 * 1024 * 1024 });
+  const link = new HttpLink({
+    uri: "https://api.github.com/graphql",
+    fetch: globalThis.fetch,
+    headers: { authorization: `Bearer ${token}` }
+  });
+  const client = new ApolloClient({ cache, link });
+  return { client, gql };
+}
 async function getViewerLogin(client) {
   const query = (
     /* GraphQL */
@@ -252,6 +314,7 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
             parent {
               nameWithOwner
               defaultBranchRef {
+                name
                 target {
                   ... on Commit {
                     history(first: 0) {
@@ -262,6 +325,7 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
               }
             }
             defaultBranchRef {
+              name
               target {
                 ... on Commit {
                   history(first: 0) {
@@ -272,7 +336,9 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
             }` : `
             parent {
               nameWithOwner
-            }`}
+            }
+            defaultBranchRef { name }
+            `}
           }
         }
       }
@@ -294,6 +360,78 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
     rateLimit: res.rateLimit
   };
 }
+async function fetchViewerReposPageUnified(token, first, after, orderBy, includeForkTracking = true, fetchPolicy = "cache-first") {
+  const isApolloEnabled = true;
+  const debug = process.env.GH_MANAGER_DEBUG === "1";
+  if (debug) {
+    console.log(`\u{1F50D} Apollo enabled: ${isApolloEnabled}, Policy: ${fetchPolicy}, After: ${after || "null"}`);
+  }
+  try {
+    if (isApolloEnabled) {
+      if (debug) console.log("\u{1F680} Attempting Apollo Client...");
+      const ap = await makeApolloClient(token);
+      const sortField = orderBy?.field || "UPDATED_AT";
+      const sortDirection = orderBy?.direction || "DESC";
+      const q = ap.gql`
+        query ViewerRepos($first: Int!, $after: String, $sortField: RepositoryOrderField!, $sortDirection: OrderDirection!) {
+          rateLimit { limit remaining resetAt }
+          viewer {
+            repositories(ownerAffiliations: OWNER, first: $first, after: $after, orderBy: { field: $sortField, direction: $sortDirection }) {
+              totalCount
+              pageInfo { endCursor hasNextPage }
+              nodes {
+                id
+                name
+                nameWithOwner
+                description
+                visibility
+                isPrivate
+                isFork
+                isArchived
+                stargazerCount
+                forkCount
+                primaryLanguage { name color }
+                updatedAt
+                pushedAt
+                diskUsage
+                ${includeForkTracking ? `
+                parent { nameWithOwner defaultBranchRef { name target { ... on Commit { history(first: 0) { totalCount } } } } }
+                defaultBranchRef { name target { ... on Commit { history(first: 0) { totalCount } } } }` : `
+                parent { nameWithOwner }
+                defaultBranchRef { name }`}
+              }
+            }
+          }
+        }
+      `;
+      const startTime = Date.now();
+      const res = await ap.client.query({
+        query: q,
+        variables: { first, after: after ?? null, sortField, sortDirection },
+        fetchPolicy
+      });
+      const duration = Date.now() - startTime;
+      if (debug) {
+        console.log(`\u26A1 Apollo query completed in ${duration}ms`);
+        console.log(`\u{1F4CA} From cache: ${res.loading === false && duration < 50 ? "YES" : "NO"}`);
+        console.log(`\u{1F504} Network status: ${res.networkStatus}`);
+      }
+      const data = res.data.viewer.repositories;
+      return {
+        nodes: data.nodes,
+        endCursor: data.pageInfo.endCursor,
+        hasNextPage: data.pageInfo.hasNextPage,
+        totalCount: data.totalCount,
+        rateLimit: res.data.rateLimit
+      };
+    }
+  } catch (e) {
+    if (debug) console.log(`\u274C Apollo failed, falling back to Octokit:`, e.message);
+  }
+  if (debug) console.log("\u{1F4E1} Using Octokit fallback...");
+  const octo = makeClient(token);
+  return fetchViewerReposPage(octo, first, after, orderBy, includeForkTracking);
+}
 async function deleteRepositoryRest(token, owner, repo) {
   const url = `https://api.github.com/repos/${owner}/${repo}`;
   const res = await fetch(url, {
@@ -370,12 +508,128 @@ async function syncForkWithUpstream(token, owner, repo, branch = "main") {
   }
   throw new Error(msg);
 }
+async function purgeApolloCacheFiles() {
+  try {
+    const fs3 = await import("fs");
+    const path3 = await import("path");
+    const envPaths3 = (await import("env-paths")).default;
+    const p = envPaths3("gh-manager-cli").data;
+    const cacheFile = path3.join(p, "apollo-cache.json");
+    const metaFile = path3.join(p, "apollo-cache-meta.json");
+    if (process.env.GH_MANAGER_DEBUG === "1") {
+      console.log(`\u{1F5D1}\uFE0F  Purging cache files from: ${p}`);
+    }
+    try {
+      fs3.unlinkSync(cacheFile);
+    } catch {
+    }
+    try {
+      fs3.unlinkSync(metaFile);
+    } catch {
+    }
+  } catch {
+  }
+}
+async function inspectCacheStatus() {
+  try {
+    const fs3 = await import("fs");
+    const path3 = await import("path");
+    const envPaths3 = (await import("env-paths")).default;
+    const p = envPaths3("gh-manager-cli").data;
+    const cacheFile = path3.join(p, "apollo-cache.json");
+    const metaFile = path3.join(p, "apollo-cache-meta.json");
+    process.stderr.write(`
+\u{1F4C2} Cache directory: ${p}
+`);
+    try {
+      const cacheStats = fs3.statSync(cacheFile);
+      process.stderr.write(`\u{1F4BE} Cache file: ${Math.round(cacheStats.size / 1024)}KB (${cacheStats.mtime.toISOString()})
+`);
+    } catch {
+      process.stderr.write(`\u{1F4BE} Cache file: NOT FOUND
+`);
+    }
+    try {
+      const metaStats = fs3.statSync(metaFile);
+      const metaContent = fs3.readFileSync(metaFile, "utf8");
+      const meta = JSON.parse(metaContent);
+      process.stderr.write(`\u{1F4CA} Meta file: ${Object.keys(meta.fetched || {}).length} entries (${metaStats.mtime.toISOString()})
+`);
+      const entries = Object.entries(meta.fetched || {});
+      if (entries.length > 0) {
+        process.stderr.write("\u{1F4CB} Recent cache entries:\n");
+        entries.slice(-3).forEach(([key, timestamp]) => {
+          const age = Date.now() - Date.parse(timestamp);
+          process.stderr.write(`   ${key} (${Math.round(age / 1e3)}s ago)
+`);
+        });
+      }
+    } catch {
+      process.stderr.write(`\u{1F4CA} Meta file: NOT FOUND
+`);
+    }
+    process.stderr.write("\n");
+  } catch (e) {
+    process.stderr.write(`\u274C Cache inspection failed: ${e.message}
+`);
+  }
+}
 
 // src/ui/RepoList.tsx
 import { useEffect, useMemo, useState } from "react";
 import { Box, Text, useApp, useInput, useStdout } from "ink";
 import TextInput from "ink-text-input";
 import chalk from "chalk";
+
+// src/apolloMeta.ts
+import fs2 from "fs";
+import path2 from "path";
+import envPaths2 from "env-paths";
+var paths2 = envPaths2("gh-manager-cli");
+var dataDir = paths2.data;
+var metaPath = path2.join(dataDir, "apollo-cache-meta.json");
+var VERSION = 1;
+function readMeta() {
+  try {
+    const raw = fs2.readFileSync(metaPath, "utf8");
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object" && parsed.fetched) return parsed;
+  } catch {
+  }
+  return { version: VERSION, fetched: {} };
+}
+function writeMeta(meta) {
+  try {
+    fs2.mkdirSync(dataDir, { recursive: true });
+    fs2.writeFileSync(metaPath, JSON.stringify(meta, null, 2), "utf8");
+    if (process.platform !== "win32") {
+      try {
+        fs2.chmodSync(metaPath, 384);
+      } catch {
+      }
+    }
+  } catch {
+  }
+}
+function makeApolloKey(opts) {
+  const v = opts.viewer || "unknown";
+  return `viewer:${v}|sort:${opts.sortKey}:${opts.sortDir}|ps:${opts.pageSize}|forks:${opts.forkTracking ? "1" : "0"}`;
+}
+function isFresh(key, ttlMs = Number(process.env.APOLLO_TTL_MS || 30 * 60 * 1e3)) {
+  const meta = readMeta();
+  const iso = meta.fetched[key];
+  if (!iso) return false;
+  const t = Date.parse(iso);
+  if (!isFinite(t)) return false;
+  return Date.now() - t < ttlMs;
+}
+function markFetched(key) {
+  const meta = readMeta();
+  meta.fetched[key] = (/* @__PURE__ */ new Date()).toISOString();
+  writeMeta(meta);
+}
+
+// src/ui/RepoList.tsx
 import { exec } from "child_process";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 var PAGE_SIZE = process.env.GH_MANAGER_DEV === "1" || process.env.NODE_ENV === "development" ? 5 : 15;
@@ -441,7 +695,7 @@ function RepoRow({ repo, selected, index, maxWidth, spacingLines, dim, forkTrack
     spacingLines > 0 && /* @__PURE__ */ jsx(Box, { height: spacingLines, children: /* @__PURE__ */ jsx(Text, { children: " " }) })
   ] });
 }
-function RepoList({ token, maxVisibleRows, onLogout }) {
+function RepoList({ token, maxVisibleRows, onLogout, viewerLogin }) {
   const { exit } = useApp();
   const { stdout } = useStdout();
   const client = useMemo(() => makeClient(token), [token]);
@@ -479,6 +733,7 @@ function RepoList({ token, maxVisibleRows, onLogout }) {
   const [syncing, setSyncing] = useState(false);
   const [syncError, setSyncError] = useState(null);
   const [syncFocus, setSyncFocus] = useState("confirm");
+  const [infoMode, setInfoMode] = useState(false);
   const [logoutMode, setLogoutMode] = useState(false);
   const [logoutFocus, setLogoutFocus] = useState("confirm");
   const [logoutError, setLogoutError] = useState(null);
@@ -536,7 +791,7 @@ function RepoList({ token, maxVisibleRows, onLogout }) {
     "name": "NAME",
     "stars": "STARGAZERS"
   };
-  const fetchPage = async (after, reset = false, isSortChange = false, overrideForkTracking) => {
+  const fetchPage = async (after, reset = false, isSortChange = false, overrideForkTracking, policy) => {
     if (isSortChange) {
       setSortingLoading(true);
     } else if (after && !reset) {
@@ -549,11 +804,31 @@ function RepoList({ token, maxVisibleRows, onLogout }) {
         field: sortFieldMap[sortKey],
         direction: sortDir.toUpperCase()
       };
-      const page = await fetchViewerReposPage(client, PAGE_SIZE, after ?? null, orderBy, overrideForkTracking ?? forkTracking);
+      const page = await fetchViewerReposPageUnified(
+        token,
+        PAGE_SIZE,
+        after ?? null,
+        orderBy,
+        overrideForkTracking ?? forkTracking,
+        policy ?? (after ? "network-only" : "cache-first")
+      );
       setItems((prev) => reset || !after ? page.nodes : [...prev, ...page.nodes]);
       setEndCursor(page.endCursor);
       setHasNextPage(page.hasNextPage);
       setTotalCount(page.totalCount);
+      if (!after) {
+        try {
+          const key = makeApolloKey({
+            viewer: viewerLogin || "unknown",
+            sortKey,
+            sortDir,
+            pageSize: PAGE_SIZE,
+            forkTracking: overrideForkTracking ?? forkTracking
+          });
+          markFetched(key);
+        } catch {
+        }
+      }
       if (page.rateLimit && rateLimit) {
         setPrevRateLimit(rateLimit.remaining);
       }
@@ -583,11 +858,35 @@ function RepoList({ token, maxVisibleRows, onLogout }) {
   }, []);
   useEffect(() => {
     if (!prefsLoaded) return;
-    fetchPage();
+    let policy = "cache-first";
+    try {
+      const key = makeApolloKey({
+        viewer: viewerLogin || "unknown",
+        sortKey,
+        sortDir,
+        pageSize: PAGE_SIZE,
+        forkTracking
+      });
+      policy = isFresh(key) ? "cache-first" : "cache-and-network";
+    } catch {
+    }
+    fetchPage(null, true, false, void 0, policy);
   }, [client, prefsLoaded]);
   useEffect(() => {
     if (items.length > 0) {
-      fetchPage(null, true, true);
+      let policy = "cache-first";
+      try {
+        const key = makeApolloKey({
+          viewer: viewerLogin || "unknown",
+          sortKey,
+          sortDir,
+          pageSize: PAGE_SIZE,
+          forkTracking
+        });
+        policy = isFresh(key) ? "cache-first" : "cache-and-network";
+      } catch {
+      }
+      fetchPage(null, true, true, void 0, policy);
     }
   }, [sortKey, sortDir]);
   useInput((input, key) => {
@@ -677,7 +976,8 @@ function RepoList({ token, maxVisibleRows, onLogout }) {
           try {
             setSyncing(true);
             const [owner, repo] = syncTarget.nameWithOwner.split("/");
-            const result = await syncForkWithUpstream(token, owner, repo);
+            const branchName = syncTarget.defaultBranchRef?.name || "main";
+            const result = await syncForkWithUpstream(token, owner, repo, branchName);
             setItems((prev) => prev.map((r) => {
               if (r.id === syncTarget.id && r.parent && r.defaultBranchRef?.target?.history && r.parent.defaultBranchRef?.target?.history) {
                 return {
@@ -734,6 +1034,13 @@ function RepoList({ token, maxVisibleRows, onLogout }) {
       }
       return;
     }
+    if (infoMode) {
+      if (key.escape || input && input.toUpperCase() === "I") {
+        setInfoMode(false);
+        return;
+      }
+      return;
+    }
     if (filterMode) {
       if (key.escape) {
         setFilterMode(false);
@@ -786,7 +1093,14 @@ function RepoList({ token, maxVisibleRows, onLogout }) {
       setCursor(0);
       setRefreshing(true);
       setSortingLoading(true);
-      fetchPage(null, true, true);
+      ;
+      (async () => {
+        try {
+          await purgeApolloCacheFiles();
+        } catch {
+        }
+        fetchPage(null, true, true, void 0, "network-only");
+      })();
     }
     if (key.ctrl && (input === "a" || input === "A")) {
       const repo = filteredAndSorted[cursor];
@@ -818,10 +1132,24 @@ function RepoList({ token, maxVisibleRows, onLogout }) {
       setLogoutFocus("confirm");
       return;
     }
+    if (key.ctrl && key.shift && (input === "d" || input === "D") || process.env.GH_MANAGER_DEBUG === "1" && input === "i") {
+      (async () => {
+        try {
+          await inspectCacheStatus();
+        } catch (e) {
+          console.log("Failed to inspect cache:", e);
+        }
+      })();
+      return;
+    }
     if (input === "/") {
       setFilterMode(true);
       return;
     }
+    if (input && input.toUpperCase() === "I") {
+      setInfoMode(true);
+      return;
+    }
     if (input && input.toUpperCase() === "S") {
       const order = ["updated", "pushed", "name", "stars"];
       const idx = order.indexOf(sortKey);
@@ -928,7 +1256,7 @@ function RepoList({ token, maxVisibleRows, onLogout }) {
     exec(cmd);
   }
   const lowRate = rateLimit && rateLimit.remaining <= Math.ceil(rateLimit.limit * 0.1);
-  const modalOpen = deleteMode || archiveMode || syncMode || logoutMode;
+  const modalOpen = deleteMode || archiveMode || syncMode || logoutMode || infoMode;
   const headerBar = useMemo(() => /* @__PURE__ */ jsxs(Box, { flexDirection: "row", justifyContent: "space-between", height: 1, marginBottom: 1, children: [
     /* @__PURE__ */ jsxs(Box, { flexDirection: "row", gap: 1, children: [
       /* @__PURE__ */ jsx(Text, { bold: true, color: modalOpen ? "gray" : void 0, dimColor: modalOpen ? true : void 0, children: "  Repositories" }),
@@ -1273,7 +1601,42 @@ function RepoList({ token, maxVisibleRows, onLogout }) {
         logoutFocus === "confirm" ? "Logout" : "Cancel",
         " \u2022 Y to confirm \u2022 C to cancel"
       ] }) })
-    ] }) }) : /* @__PURE__ */ jsxs(Fragment, { children: [
+    ] }) }) : infoMode ? /* @__PURE__ */ jsx(Box, { height: contentHeight, alignItems: "center", justifyContent: "center", children: (() => {
+      const repo = filteredAndSorted[cursor];
+      if (!repo) return /* @__PURE__ */ jsx(Text, { color: "red", children: "No repository selected." });
+      const langName = repo.primaryLanguage?.name || "N/A";
+      const langColor = repo.primaryLanguage?.color || "#666666";
+      return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "magenta", paddingX: 3, paddingY: 2, width: Math.min(terminalWidth - 8, 90), children: [
+        /* @__PURE__ */ jsx(Text, { bold: true, children: "Repository Info" }),
+        /* @__PURE__ */ jsx(Box, { height: 1, children: /* @__PURE__ */ jsx(Text, { children: " " }) }),
+        /* @__PURE__ */ jsx(Text, { children: chalk.bold(repo.nameWithOwner) }),
+        repo.description && /* @__PURE__ */ jsx(Text, { color: "gray", children: repo.description }),
+        /* @__PURE__ */ jsx(Box, { height: 1, children: /* @__PURE__ */ jsx(Text, { children: " " }) }),
+        /* @__PURE__ */ jsxs(Text, { children: [
+          repo.isPrivate ? chalk.yellow("Private") : chalk.green("Public"),
+          repo.isArchived ? chalk.gray("  Archived") : "",
+          repo.isFork ? chalk.blue("  Fork") : ""
+        ] }),
+        /* @__PURE__ */ jsx(Text, { children: chalk.gray(`\u2605 ${repo.stargazerCount}  \u2442 ${repo.forkCount}`) }),
+        /* @__PURE__ */ jsxs(Text, { children: [
+          chalk.hex(langColor)(`\u25CF `),
+          chalk.gray(`${langName}`)
+        ] }),
+        /* @__PURE__ */ jsxs(Text, { color: "gray", children: [
+          "Updated: ",
+          formatDate(repo.updatedAt),
+          " \u2022 Pushed: ",
+          formatDate(repo.pushedAt)
+        ] }),
+        /* @__PURE__ */ jsxs(Text, { color: "gray", children: [
+          "Size: ",
+          repo.diskUsage,
+          " KB"
+        ] }),
+        /* @__PURE__ */ jsx(Box, { height: 1, children: /* @__PURE__ */ jsx(Text, { children: " " }) }),
+        /* @__PURE__ */ jsx(Text, { color: "gray", children: "Press Esc or I to close" })
+      ] });
+    })() }) : /* @__PURE__ */ jsxs(Fragment, { children: [
       /* @__PURE__ */ jsxs(Box, { flexDirection: "row", gap: 2, marginBottom: 1, children: [
         /* @__PURE__ */ jsxs(Text, { color: "gray", dimColor: true, children: [
           "Sort: ",
@@ -1328,7 +1691,10 @@ function RepoList({ token, maxVisibleRows, onLogout }) {
     ] }) }),
     /* @__PURE__ */ jsxs(Box, { marginTop: 1, paddingX: 1, flexDirection: "column", children: [
       /* @__PURE__ */ jsx(Box, { width: terminalWidth, justifyContent: "center", children: /* @__PURE__ */ jsx(Text, { color: "gray", dimColor: modalOpen ? true : void 0, children: "\u2191\u2193 Navigate \u2022 Ctrl+G Top \u2022 G Bottom \u2022 / Filter \u2022 S Sort \u2022 D Direction \u2022 T Density \u2022 F Forks - Commits Behind \u2022 \u23CE/O Open" }) }),
-      /* @__PURE__ */ jsx(Box, { width: terminalWidth, justifyContent: "center", children: /* @__PURE__ */ jsx(Text, { color: "gray", dimColor: modalOpen ? true : void 0, children: "Del/Ctrl+Backspace Delete \u2022 Ctrl+A Un/Archive \u2022 Ctrl+U Sync Fork \u2022 Ctrl+L Logout \u2022 R Refresh \u2022 Q Quit" }) })
+      /* @__PURE__ */ jsx(Box, { width: terminalWidth, justifyContent: "center", children: /* @__PURE__ */ jsxs(Text, { color: "gray", dimColor: modalOpen ? true : void 0, children: [
+        "Del/Ctrl+Backspace Delete \u2022 Ctrl+A Un/Archive \u2022 Ctrl+U Sync Fork \u2022 Ctrl+L Logout \u2022 R Refresh \u2022 Q Quit",
+        process.env.GH_MANAGER_DEBUG === "1" && " \u2022 I Cache Info"
+      ] }) })
     ] })
   ] });
 }
@@ -1605,7 +1971,15 @@ function App() {
   }
   return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", height: dims.rows, paddingX: 2, paddingTop: verticalPadding, paddingBottom: verticalPadding, children: [
     header,
-    /* @__PURE__ */ jsx2(RepoList, { token, maxVisibleRows: dims.rows - verticalPadding * 2 - 4, onLogout: handleLogout })
+    /* @__PURE__ */ jsx2(
+      RepoList,
+      {
+        token,
+        maxVisibleRows: dims.rows - verticalPadding * 2 - 4,
+        onLogout: handleLogout,
+        viewerLogin: viewer ?? void 0
+      }
+    )
   ] });
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gh-manager-cli",
-  "version": "1.4.2",
+  "version": "1.6.0",
   "private": false,
   "description": "Interactive CLI to manage your GitHub repos (personal) with Ink",
   "license": "MIT",
@@ -29,13 +29,18 @@
     "build:binaries": "npm run build && pkg dist/index.js --targets node18-linux-x64,node18-macos-x64,node18-windows-x64 --out-path ./binaries",
     "dev": "tsup --watch",
     "start": "node dist/index.js",
+    "start:cache": "GH_MANAGER_APOLLO=1 GH_MANAGER_DEBUG=1 node dist/index.js",
+    "start:no-cache": "GH_MANAGER_APOLLO=0 GH_MANAGER_DEBUG=1 node dist/index.js",
+    "test:cache": "pnpm build && pnpm start:cache",
     "prepublishOnly": "pnpm run build"
   },
   "engines": {
     "node": ">=18"
   },
   "dependencies": {
+    "@apollo/client": "^3.11.10",
     "@octokit/graphql": "^9.0.1",
+    "apollo3-cache-persist": "^0.14.1",
     "chalk": "^5.6.0",
     "dotenv": "^17.2.1",
     "env-paths": "^3.0.0",