gh-manager-cli 1.18.1 → 1.19.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [1.19.0](https://github.com/wiiiimm/gh-manager-cli/compare/v1.18.1...v1.19.0) (2025-09-02)
+
+
+### Features
+
+* **cli:** add org (-o) and token (-t) flags ([#18](https://github.com/wiiiimm/gh-manager-cli/issues/18)) ([029376e](https://github.com/wiiiimm/gh-manager-cli/commit/029376e1465eb9376850c6e19ef2b514020a4542))
+
 ## [1.18.1](https://github.com/wiiiimm/gh-manager-cli/compare/v1.18.0...v1.18.1) (2025-09-02)
 
 

package/README.md

@@ -208,6 +208,29 @@ Notes:
 
 Launch the app, then use the keys below:
 
+### CLI Flags
+
+- `--org, -o <slug>`: Start in a specific organisation context (if accessible). Ignores the flag if you don’t have access or if the slug isn’t an organisation.
+  - Examples:
+    - `gh-manager-cli --org acme`
+    - `gh-manager-cli -o acme`
+    - `npx gh-manager-cli --org=@acme`
+    - `npx gh-manager-cli -o=@acme`
+  - Notes:
+    - Leading `@` is optional.
+    - Personal usernames are not supported by `--org`/`-o` (use default personal context).
+
+- `--token, -t <pat>`: Use a Personal Access Token just for this run. Does not persist to config.
+  - Examples:
+    - `gh-manager-cli --token ghp_XXXXXXXXXXXXXXXXXXXXXXXXXXXX`
+    - `gh-manager-cli -t=ghp_XXXXXXXXXXXXXXXXXXXXXXXXXXXX`
+  - Precedence: CLI token > `GITHUB_TOKEN`/`GH_TOKEN` env vars > stored config.
+  - Security: Supplying tokens on the command line may be captured in shell history. Prefer env vars or the interactive prompt when possible.
+
+- `--help, -h`: Show usage information and exit.
+
+- `--version, -v`: Print the current version and exit.
+
 ### Navigation & View Controls
 - **Top/Bottom**: `Ctrl+G` (top), `G` (bottom)
 - **Page Navigation**: ↑↓ Arrow keys, PageUp/PageDown

package/dist/index.js

@@ -28,7 +28,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "gh-manager-cli",
-      version: "1.18.1",
+      version: "1.19.0",
       private: false,
       description: "Interactive CLI to manage your GitHub repos (personal) with Ink",
       license: "MIT",
@@ -404,7 +404,7 @@ async function openGitHubAuthorizationPage() {
 }
 
 // src/ui/RepoList.tsx
-import React10, { useEffect as useEffect7, useMemo, useState as useState10, useRef } from "react";
+import React10, { useEffect as useEffect7, useMemo, useState as useState10, useRef, useCallback } from "react";
 import { Box as Box13, Text as Text14, useApp, useInput as useInput10, useStdout } from "ink";
 import TextInput4 from "ink-text-input";
 import chalk11 from "chalk";
@@ -497,8 +497,8 @@ function OrgSwitcher({ token, currentContext, onSelect, onClose }) {
       }
       setEnterpriseOrgs(entOrgs);
       if (!isPersonalContext) {
-        const orgLogin2 = currentContext.login;
-        const index = orgs.findIndex((org) => org.login === orgLogin2);
+        const orgLogin = currentContext.login;
+        const index = orgs.findIndex((org) => org.login === orgLogin);
         if (index !== -1) {
           setCursor(index + 1);
         }
@@ -1223,16 +1223,20 @@ var getPageSize = () => {
   return 15;
 };
 var PAGE_SIZE = getPageSize();
-function RepoList({ token, maxVisibleRows, onLogout, viewerLogin, onOrgContextChange }) {
+function RepoList({ token, maxVisibleRows, onLogout, viewerLogin, onOrgContextChange, initialOrgSlug: initialOrgSlug2 }) {
   const { exit } = useApp();
   const { stdout } = useStdout();
   const client = useMemo(() => makeClient(token), [token]);
   const [debugMessages, setDebugMessages] = useState10([]);
-  const addDebugMessage = (msg) => {
+  const addDebugMessage = useCallback((msg) => {
     if (process.env.GH_MANAGER_DEBUG === "1") {
       setDebugMessages((prev) => [...prev.slice(-9), msg]);
     }
-  };
+  }, []);
+  const handleOrgContextChangeRef = useRef(onOrgContextChange);
+  useEffect7(() => {
+    handleOrgContextChangeRef.current = onOrgContextChange;
+  }, [onOrgContextChange]);
   React10.useEffect(() => {
     addDebugMessage(`[RepoList] Component mounted`);
     logger.info("RepoList component mounted", {
@@ -1299,6 +1303,35 @@ function RepoList({ token, maxVisibleRows, onLogout, viewerLogin, onOrgContextCh
   const [changingVisibility, setChangingVisibility] = useState10(false);
   const [changeVisibilityError, setChangeVisibilityError] = useState10(null);
   const [sortMode, setSortMode] = useState10(false);
+  const appliedInitialOrg = useRef(false);
+  useEffect7(() => {
+    (async () => {
+      if (appliedInitialOrg.current) return;
+      if (!initialOrgSlug2) return;
+      if (!token) return;
+      if (!prefsLoaded) {
+        return;
+      }
+      appliedInitialOrg.current = true;
+      try {
+        const orgs = await fetchViewerOrganizations(client);
+        const slug = initialOrgSlug2.replace(/^@/, "");
+        const match = orgs.find((o) => o.login.toLowerCase() === slug.toLowerCase());
+        if (match) {
+          await handleOrgContextChange({
+            type: "organization",
+            login: match.login,
+            name: match.name || void 0
+          });
+          addDebugMessage(`[--org] Switched context to @${match.login}`);
+        } else {
+          addDebugMessage(`[--org] No access to org @${slug}, ignoring flag`);
+        }
+      } catch (e) {
+        addDebugMessage(`[--org] Failed to apply org flag: ${e.message || e}`);
+      }
+    })();
+  }, [initialOrgSlug2, token, prefsLoaded, client, addDebugMessage]);
   function closeArchiveModal() {
     setArchiveMode(false);
     setArchiveTarget(null);
@@ -1429,7 +1462,7 @@ function RepoList({ token, maxVisibleRows, onLogout, viewerLogin, onOrgContextCh
       visibilityFilter: "all"
     });
     if (onOrgContextChange) {
-      onOrgContextChange(newContext);
+      handleOrgContextChangeRef.current?.(newContext);
     }
   }
   function cancelDeleteModal() {
@@ -1502,7 +1535,7 @@ function RepoList({ token, maxVisibleRows, onLogout, viewerLogin, onOrgContextCh
         field: sortFieldMap[sortKey],
         direction: sortDir.toUpperCase()
       };
-      const orgLogin2 = ownerContext !== "personal" ? ownerContext.login : void 0;
+      const orgLogin = ownerContext !== "personal" ? ownerContext.login : void 0;
       let privacy;
       if (visibilityFilter === "public") privacy = "PUBLIC";
       else if (visibilityFilter === "private") privacy = "PRIVATE";
@@ -1514,7 +1547,7 @@ function RepoList({ token, maxVisibleRows, onLogout, viewerLogin, onOrgContextCh
         overrideForkTracking ?? forkTracking,
         policy ?? (after ? "network-only" : "cache-first"),
         ownerAffiliations,
-        orgLogin2,
+        orgLogin,
         privacy
       );
       setItems((prev) => reset || !after ? page.nodes : [...prev, ...page.nodes]);
@@ -1524,9 +1557,9 @@ function RepoList({ token, maxVisibleRows, onLogout, viewerLogin, onOrgContextCh
       if (page.nodes.some((repo) => repo.visibility === "INTERNAL")) {
         setHasInternalRepos(true);
       }
-      if (!after && orgLogin2) {
+      if (!after && orgLogin) {
         const client2 = makeClient(token);
-        checkOrganizationIsEnterprise(client2, orgLogin2).then((isEnt) => {
+        checkOrganizationIsEnterprise(client2, orgLogin).then((isEnt) => {
           setIsEnterpriseOrg(isEnt);
         });
       }
@@ -1538,7 +1571,7 @@ function RepoList({ token, maxVisibleRows, onLogout, viewerLogin, onOrgContextCh
             sortDir,
             pageSize: PAGE_SIZE,
             forkTracking: overrideForkTracking ?? forkTracking,
-            ownerContext: orgLogin2 ? `org:${orgLogin2}` : "personal",
+            ownerContext: orgLogin ? `org:${orgLogin}` : "personal",
             affiliations: ownerAffiliations.join(",")
           });
           markFetched(key);
@@ -1577,8 +1610,8 @@ function RepoList({ token, maxVisibleRows, onLogout, viewerLogin, onOrgContextCh
     setSearchLoading(true);
     try {
       const orderBy = { field: sortFieldMap[sortKey], direction: sortDir.toUpperCase() };
-      const orgLogin2 = ownerContext !== "personal" ? ownerContext.login : void 0;
-      addDebugMessage(`[fetchSearchPage] Calling API with viewer="${viewerLogin}", orgLogin="${orgLogin2 || "none"}", query="${query.trim()}"`);
+      const orgLogin = ownerContext !== "personal" ? ownerContext.login : void 0;
+      addDebugMessage(`[fetchSearchPage] Calling API with viewer="${viewerLogin}", orgLogin="${orgLogin || "none"}", query="${query.trim()}"`);
       const page = await searchRepositoriesUnified(
         token,
         viewerLogin,
@@ -1589,7 +1622,7 @@ function RepoList({ token, maxVisibleRows, onLogout, viewerLogin, onOrgContextCh
         orderBy.direction,
         forkTracking,
         policy ?? (after ? "network-only" : "cache-first"),
-        orgLogin2
+        orgLogin
       );
       addDebugMessage(`[fetchSearchPage] API returned ${page.nodes.length} results, totalCount=${page.totalCount}`);
       if (page.nodes.length > 0) {
@@ -1642,7 +1675,7 @@ function RepoList({ token, maxVisibleRows, onLogout, viewerLogin, onOrgContextCh
     if (ui.ownerContext) {
       setOwnerContext(ui.ownerContext);
       if (onOrgContextChange) {
-        onOrgContextChange(ui.ownerContext);
+        handleOrgContextChangeRef.current?.(ui.ownerContext);
       }
       if (ui.ownerContext !== "personal") {
         const client2 = makeClient(token);
@@ -1659,7 +1692,7 @@ function RepoList({ token, maxVisibleRows, onLogout, viewerLogin, onOrgContextCh
   useEffect7(() => {
     if (!prefsLoaded) return;
     let policy = "cache-first";
-    const orgLogin2 = ownerContext !== "personal" ? ownerContext.login : void 0;
+    const orgLogin = ownerContext !== "personal" ? ownerContext.login : void 0;
     try {
       const key = makeApolloKey({
         viewer: viewerLogin || "unknown",
@@ -1667,7 +1700,7 @@ function RepoList({ token, maxVisibleRows, onLogout, viewerLogin, onOrgContextCh
         sortDir,
         pageSize: PAGE_SIZE,
         forkTracking,
-        ownerContext: orgLogin2 ? `org:${orgLogin2}` : "personal",
+        ownerContext: orgLogin ? `org:${orgLogin}` : "personal",
         affiliations: ownerAffiliations.join(",")
       });
       policy = isFresh(key) ? "cache-first" : "network-only";
@@ -1680,7 +1713,7 @@ function RepoList({ token, maxVisibleRows, onLogout, viewerLogin, onOrgContextCh
     if (!searchActive) {
       if (items.length > 0) {
         let policy = "cache-first";
-        const orgLogin2 = ownerContext !== "personal" ? ownerContext.login : void 0;
+        const orgLogin = ownerContext !== "personal" ? ownerContext.login : void 0;
         try {
           const key = makeApolloKey({
             viewer: viewerLogin || "unknown",
@@ -1688,7 +1721,7 @@ function RepoList({ token, maxVisibleRows, onLogout, viewerLogin, onOrgContextCh
             sortDir,
             pageSize: PAGE_SIZE,
             forkTracking,
-            ownerContext: orgLogin2 ? `org:${orgLogin2}` : "personal",
+            ownerContext: orgLogin ? `org:${orgLogin}` : "personal",
             affiliations: ownerAffiliations.join(",")
           });
           policy = isFresh(key) ? "cache-first" : "network-only";
@@ -1720,7 +1753,7 @@ function RepoList({ token, maxVisibleRows, onLogout, viewerLogin, onOrgContextCh
       if (!searchActive) {
         if (items.length > 0) {
           let policy = "network-only";
-          const orgLogin2 = ownerContext !== "personal" ? ownerContext.login : void 0;
+          const orgLogin = ownerContext !== "personal" ? ownerContext.login : void 0;
           fetchPage(null, true, true, void 0, policy);
         }
       } else {
@@ -1736,6 +1769,7 @@ function RepoList({ token, maxVisibleRows, onLogout, viewerLogin, onOrgContextCh
     if (viewerLogin && searchActive && !searchLoading && searchItems.length === 0) {
       let policy = "cache-first";
       try {
+        const orgLogin = ownerContext !== "personal" ? ownerContext.login : void 0;
         const key = makeSearchKey({
           viewer: viewerLogin || "unknown",
           q: filter.trim(),
@@ -2841,7 +2875,7 @@ function OAuthProgress({ status, error, deviceCode }) {
 // src/ui/App.tsx
 import { jsx as jsx17, jsxs as jsxs16 } from "react/jsx-runtime";
 var packageJson = require_package();
-function App() {
+function App({ initialOrgSlug: initialOrgSlug2, inlineToken: inlineToken2, inlineTokenEphemeral }) {
   const { exit } = useApp2();
   const { stdout } = useStdout2();
   const [mode, setMode] = useState12("checking");
@@ -2855,6 +2889,7 @@ function App() {
   const [authMethod, setAuthMethod] = useState12("pat");
   const [oauthStatus, setOAuthStatus] = useState12("initializing");
   const [tokenSource, setTokenSource] = useState12("pat");
+  const [sessionTokenOrigin, setSessionTokenOrigin] = useState12("stored");
   const [deviceCodeResponse, setDeviceCodeResponse] = useState12(null);
   const [oauthDeviceCode, setOauthDeviceCode] = useState12(null);
   const [dims, setDims] = useState12(() => {
@@ -2879,16 +2914,25 @@ function App() {
     const stored = getStoredToken();
     const source = getTokenSource();
     setTokenSource(source);
-    if (env) {
+    if (inlineToken2) {
+      setToken(inlineToken2);
+      setSessionTokenOrigin("cli");
+      setTokenSource("pat");
+      setMode("validating");
+    } else if (env) {
       setToken(env);
+      setSessionTokenOrigin("env");
+      setTokenSource("pat");
       setMode("validating");
     } else if (stored) {
       setToken(stored);
+      setSessionTokenOrigin("stored");
       setMode("validating");
     } else {
+      setSessionTokenOrigin("prompt");
       setMode("auth_method_selection");
     }
-  }, []);
+  }, [inlineToken2]);
   useEffect8(() => {
     if (mode !== "oauth_flow") return;
     (async () => {
@@ -2915,6 +2959,7 @@ function App() {
           storeToken(tokenResult.token, "oauth");
           setToken(tokenResult.token);
           setTokenSource("oauth");
+          setSessionTokenOrigin("oauth");
           if (tokenResult.login) {
             setViewer(tokenResult.login);
             setOAuthStatus("success");
@@ -2953,16 +2998,18 @@ function App() {
         const login = await getViewerLogin(client);
         clearTimeout(timeoutId);
         setViewer(login);
-        logger.info("User authenticated successfully", {
-          user: login,
-          tokenSource,
-          tokenStored: !getStoredToken()
-        });
         setWasRateLimited(false);
         setRateLimitReset(null);
-        if (!getStoredToken()) {
+        const hadStored = Boolean(getStoredToken());
+        const shouldPersist = !hadStored && !inlineTokenEphemeral && (sessionTokenOrigin === "prompt" || sessionTokenOrigin === "oauth");
+        if (shouldPersist) {
           storeToken(token);
         }
+        logger.info("User authenticated successfully", {
+          user: login,
+          tokenOrigin: sessionTokenOrigin,
+          willPersist: shouldPersist
+        });
         setInput("");
         setMode("ready");
       } catch (e) {
@@ -3015,7 +3062,12 @@ function App() {
           setError(errorMessage);
           setInput("");
           setToken(null);
-          clearStoredToken();
+          if (sessionTokenOrigin === "stored") {
+            try {
+              clearStoredToken();
+            } catch {
+            }
+          }
           setMode("auth_method_selection");
         }
       }
@@ -3025,13 +3077,14 @@ function App() {
     if (!input.trim()) return;
     setToken(input.trim());
     setTokenSource("pat");
+    setSessionTokenOrigin("prompt");
     setError(null);
     setMode("validating");
   };
   const handleLogout = () => {
     logger.info("User logged out", {
       previousUser: viewer,
-      tokenSource
+      tokenOrigin: sessionTokenOrigin
     });
     try {
       clearStoredToken();
@@ -3214,7 +3267,8 @@ function App() {
         maxVisibleRows: dims.rows - verticalPadding * 2 - 4,
         onLogout: handleLogout,
         viewerLogin: viewer ?? void 0,
-        onOrgContextChange: setOrgContext
+        onOrgContextChange: setOrgContext,
+        initialOrgSlug: initialOrgSlug2
       }
     )
   ] });
@@ -3223,6 +3277,31 @@ function App() {
 // src/index.tsx
 import { jsx as jsx18, jsxs as jsxs17 } from "react/jsx-runtime";
 var argv = process.argv.slice(2);
+var getFlagValue = (name) => {
+  const idx = argv.findIndex((a) => a === `--${name}` || a.startsWith(`--${name}=`));
+  if (idx === -1) return void 0;
+  const at = argv[idx];
+  if (at.includes("=")) {
+    const [, v] = at.split("=");
+    return v?.trim() || void 0;
+  }
+  const next = argv[idx + 1];
+  if (next && !next.startsWith("-")) return next.trim();
+  return void 0;
+};
+var getShortFlagValue = (short) => {
+  const exact = `-${short}`;
+  const idx = argv.findIndex((a) => a === exact || a.startsWith(`${exact}=`));
+  if (idx === -1) return void 0;
+  const at = argv[idx];
+  if (at.includes("=")) {
+    const [, v] = at.split("=");
+    return v?.trim() || void 0;
+  }
+  const next = argv[idx + 1];
+  if (next && !next.startsWith("-")) return next.trim();
+  return void 0;
+};
 if (argv.includes("--version") || argv.includes("-v")) {
   const version = import_package.default?.version || "0.0.0";
   process.stdout.write(`${version}
@@ -3234,9 +3313,11 @@ if (argv.includes("--help") || argv.includes("-h")) {
 gh-manager-cli \u2014 GitHub repo manager (Ink TUI)
 
 Usage:
-  gh-manager-cli            Launch the TUI
-  gh-manager-cli --version  Print version
-  gh-manager-cli --help     Show help
+  gh-manager-cli                     Launch the TUI
+  gh-manager-cli --org, -o <slug>    Start in an organisation context (if accessible)
+  gh-manager-cli --token, -t <pat>   Use a token just for this run (not persisted)
+  gh-manager-cli --version           Print version
+  gh-manager-cli --help              Show help
 
 Env:
   GITHUB_TOKEN / GH_TOKEN   Personal Access Token
@@ -3277,10 +3358,20 @@ process.on("unhandledRejection", (reason) => {
   console.error("Unhandled rejection:", reason?.message || reason);
   process.exit(1);
 });
+var initialOrgSlug = (() => {
+  const v = getFlagValue("org") ?? getShortFlagValue("o");
+  if (!v) return void 0;
+  return v.replace(/^@/, "");
+})();
+var inlineToken = (() => {
+  const v = getFlagValue("token") ?? getShortFlagValue("t");
+  if (!v) return void 0;
+  return v.trim();
+})();
 logger.debug("Rendering UI");
 var { unmount } = render(
   /* @__PURE__ */ jsxs17(Box17, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsx18(App, {}),
+    /* @__PURE__ */ jsx18(App, { initialOrgSlug, inlineToken, inlineTokenEphemeral: Boolean(inlineToken) }),
     /* @__PURE__ */ jsx18(Text18, { color: "gray" })
   ] })
 );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gh-manager-cli",
-  "version": "1.18.1",
+  "version": "1.19.0",
   "private": false,
   "description": "Interactive CLI to manage your GitHub repos (personal) with Ink",
   "license": "MIT",