gh-manager-cli 1.10.5 → 1.11.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [1.11.0](https://github.com/wiiiimm/gh-manager-cli/compare/v1.10.6...v1.11.0) (2025-09-01)
+
+
+### Features
+
+* add modal-based visibility filtering and sort selection ([1c72224](https://github.com/wiiiimm/gh-manager-cli/commit/1c72224b4854f69481bb21f089a926dc2c18e53f))
+
+## [1.10.6](https://github.com/wiiiimm/gh-manager-cli/compare/v1.10.5...v1.10.6) (2025-09-01)
+
+
+### Bug Fixes
+
+* clear token input field after logout and successful login ([243d963](https://github.com/wiiiimm/gh-manager-cli/commit/243d963a8603580c921d01c8380a23c0e511c113))
+
 ## [1.10.5](https://github.com/wiiiimm/gh-manager-cli/compare/v1.10.4...v1.10.5) (2025-09-01)
 
 

package/README.md

@@ -1,33 +1,36 @@
 # gh-manager-cli
 
+[![npm version](https://img.shields.io/npm/v/gh-manager-cli.svg)](https://www.npmjs.com/package/gh-manager-cli)
+[![GitHub release](https://img.shields.io/github/release/wiiiimm/gh-manager-cli.svg)](https://github.com/wiiiimm/gh-manager-cli/releases)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/node/v/gh-manager-cli.svg)](https://nodejs.org)
+[![GitHub Stars](https://img.shields.io/github/stars/wiiiimm/gh-manager-cli.svg)](https://github.com/wiiiimm/gh-manager-cli/stargazers)
+[![Context Engineered with Claude Opus 4.1](https://img.shields.io/badge/Context%20Engineered%20with-Claude%20Opus%204.1-blue)](https://www.anthropic.com)
+[![Context Engineered with Codex GPT-5](https://img.shields.io/badge/Context%20Engineered%20with-Codex%20GPT--5-green)](https://openai.com)
+
 Interactive terminal app to browse and manage your personal GitHub repositories. Built with Ink (React for CLIs) and the GitHub GraphQL API.
 
+<p align="center">
+  <img src="docs/demo_interactive.gif" alt="Interactive demo of gh-manager-cli" width="900" />
+  <br />
+  <em>Fast, keyboard-first GitHub repo management from your terminal</em>
+ </p>
+
 ## 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">
-
+  <img src="docs/demo_repo_listing.png" alt="Repository listing with metadata" width="31%" />
+  <img src="docs/demo_login.png" alt="GitHub token authentication flow" width="31%" />
+  <img src="docs/demo_delete_confirmation.png" alt="Two-step delete confirmation" width="31%" />
+  <br />
+  <sub>Listing • Auth • Delete confirmation</sub>
 </div>
 
 ## Quick Start
 
 ```bash
 # Run with npx (no install)
-npx gh-manager
+npx gh-manager-cli
 ```
 
 On first run, you'll be prompted for a GitHub Personal Access Token.
@@ -38,28 +41,34 @@ On first run, you'll be prompted for a GitHub Personal Access Token.
 - **Token Authentication**: Secure PAT storage with validation and persistence
 - **Repository Listing**: Browse all your personal repositories with metadata (stars, forks, language, etc.)
 - **Live Pagination**: Infinite scroll with automatic page prefetching
-- **Real-time Sorting**: Server-side sorting by updated, pushed, name, or stars (with direction toggle)
+- **Interactive Sorting**: Modal-based sort selection (updated, pushed, name, stars) with direction toggle
 - **Smart Search**: Server-side search through repository names and descriptions (3+ characters)
+- **Visibility Filtering**: Modal-based visibility filter (All, Public, Private, Internal for enterprise) with server-side filtering
+- **Fork Status Tracking**: Toggle display of commits behind upstream for forked repositories
 - **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
+  - Delete repository (`Del` or `Backspace`) with secure two-step confirmation
   - Archive/unarchive repositories (`Ctrl+A`) with confirmation prompts
   - Sync forks with upstream (`Ctrl+S`) with automatic conflict detection
 
 ### User Interface & Experience
 - **Keyboard Navigation**: Full keyboard control (arrow keys, PageUp/Down, `Ctrl+G`/`G`)
 - **Display Density**: Toggle between compact/cozy/comfy spacing (`T`)
-- **Visual Indicators**: Fork status, private/archived badges, language colors
+- **Visual Indicators**: Fork status, private/archived badges, language colors, visibility status
+- **Interactive Modals**: Sort selection, visibility filtering, and organization switching via modal dialogs
+- **Balanced Layout**: Repository items with spacing above and below for better visual hierarchy
 - **Loading States**: Contextual loading screens for sorting and refreshing operations
 - **Rate Limit Monitoring**: Live API usage display with visual warnings
+- **Improved Layout**: Balanced spacing above and below repository items for better visual hierarchy
 
 ### Technical Features
-- **Preference Persistence**: UI settings (sort, density) saved between sessions
+- **Preference Persistence**: UI settings (sort, density, visibility filter, fork tracking) saved between sessions
+- **Server-side Filtering**: Visibility filtering performed at GitHub API level for accurate pagination
 - **Cross-platform**: Works on macOS, Linux, and Windows
 - **Secure Storage**: Token stored with proper file permissions (0600)
 - **Error Handling**: Graceful error recovery with retry mechanisms
-- **Performance**: Efficient GraphQL queries with virtualized rendering
+- **Performance**: Efficient GraphQL queries with virtualized rendering and server-side filtering
 
 ## Installation
 
@@ -68,30 +77,30 @@ On first run, you'll be prompted for a GitHub Personal Access Token.
 Run instantly without installing:
 
 ```bash
-npx gh-manager
+npx gh-manager-cli
 ```
 
 ### NPM Global Install
 
-Install globally for persistent `gh-manager` command:
+Install globally for persistent `gh-manager-cli` command:
 
 ```bash
 npm install -g gh-manager-cli
-gh-manager
+gh-manager-cli
 ```
 
 ### Pre-built Binaries (No Node.js Required)
 
 Download standalone executables from [GitHub Releases](https://github.com/wiiiimm/gh-manager-cli/releases):
 
-- **Linux**: `gh-manager-linux-x64`
-- **macOS**: `gh-manager-macos-x64` 
-- **Windows**: `gh-manager-windows-x64.exe`
+- **Linux**: `gh-manager-cli-linux-x64`
+- **macOS**: `gh-manager-cli-macos-x64` 
+- **Windows**: `gh-manager-cli-windows-x64.exe`
 
 Make the binary executable (Linux/macOS):
 ```bash
-chmod +x gh-manager-*
-./gh-manager-*
+chmod +x gh-manager-cli-*
+./gh-manager-cli-*
 ```
 
 ### From Source
@@ -113,7 +122,7 @@ Run locally:
 node dist/index.js
 # Or add to PATH for dev
 pnpm link
-gh-manager
+gh-manager-cli
 ```
 
 ## Token & Security
@@ -131,39 +140,73 @@ The app needs a GitHub token to read your repositories.
 
 Note: Tokens are stored in plaintext on disk with restricted permissions. Future work may add OS keychain support.
 
+### PAT Permissions & Scopes
+
+Choose the least-privileged token for the features you plan to use:
+
+- Browsing/searching repos (public only): `public_repo`
+- Browsing/searching repos (includes private): `repo`
+- Archive/Unarchive repository: `repo` (and you must have admin or maintainer rights on the repo)
+- Sync fork with upstream: `repo` (you must have push rights to your fork)
+- Delete repository: `delete_repo` (and admin rights on the repo)
+
+Notes:
+- Organization repositories may require that your token is SSO-authorized if the org enforces SSO.
+- If organization data doesn’t appear in the switcher, ensure your token is authorized for that org and consider adding `read:org` (some org setups require it to list memberships).
+- Fine-grained PATs: grant Repository access to the repos you need and enable at least:
+  - Metadata: Read
+  - Contents: Read (list/search), Read & Write (sync/archive)
+  - Administration: Manage (only if you need delete)
+  If in doubt, the classic `repo` scope plus `delete_repo` (for deletion) is the simplest equivalent.
+
 ## Usage
 
 Launch the app, then use the keys below:
 
-- Navigation: Up/Down, PageUp/PageDown, `Ctrl+G` (top), `G` (bottom)
-- Refresh: `R`
-- Search: `/` to enter search mode, type 3+ characters for server-side search
+### Navigation & View Controls
+- **Top/Bottom**: `Ctrl+G` (top), `G` (bottom)
+- **Page Navigation**: ↑↓ Arrow keys, PageUp/PageDown
+- **Search**: `/` to enter search mode, type 3+ characters for server-side search
   - Down arrow or Enter: Start browsing search results
   - Esc: Clear search and return to full repository list
-- Sorting: `S` to cycle field (updated → pushed → name → stars → forks), `D` to toggle direction
-- Display density: `T` to toggle compact/cozy/comfy
-- Workspace switcher: `W` to switch between personal account and organizations
-- 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)
-  - Two-step confirm: type code → confirm (Y/Enter)
-  - Confirm: press `Y` or Enter
+- **Sort**: `S` opens sort modal with options:
+  - Updated: When the repository was last modified
+  - Pushed: When code was last pushed
+  - Name: Alphabetical by repository name
+  - Stars: Number of stars
+- **Sort Direction**: `D` to toggle ascending/descending
+- **Display Density**: `T` to toggle compact/cozy/comfy
+- **Fork Status**: `F` to toggle showing commits behind upstream
+- **Visibility Filter**: `V` opens modal (All, Public, Private, Internal for enterprise)
+
+### Navigation & Account
+- **Open in browser**: Enter or `O`
+- **Refresh**: `R`
+- **Organization switcher**: `W` to switch between personal account and organizations
+- **Logout**: `Ctrl+L`
+- **Quit**: `Q`
+
+### Repository Actions
+- **Repository info**: `I` to view detailed metadata (size, language, timestamps)
+- **Cache info**: `Ctrl+I` to inspect Apollo cache status
+- **Archive/Unarchive**: `Ctrl+A` with confirmation prompt
+- **Delete repository**: `Del` or `Backspace` (with two-step confirmation modal)
+  - Type confirmation code → confirm (Y/Enter)
   - Cancel: press `C` or Esc
-- Archive/Unarchive: `Ctrl+A`
-- Sync fork with upstream: `Ctrl+S` (for forks only, shows commit status and handles conflicts)
-- Logout: `Ctrl+L`
-- Toggle fork metrics: `F`
-- Quit: `Q`
-- Esc: cancels modals, clears search, or returns to normal listing (does not quit)
+- **Sync fork**: `Ctrl+S` (for forks only, shows commit status and handles conflicts)
+
+### General
+- **Esc**: Cancels modals, clears search, or returns to normal listing (does not quit)
+
+The header displays the current owner context (Personal Account or Organization name), active sort and direction, fork status tracking state, and active search/filter.
 
 Status bar shows loaded count vs total. A rate-limit line displays `remaining/limit` and the reset time; it turns yellow when remaining ≤ 10% of the limit.
 
 ## Pagination Details
 
 - Uses GitHub GraphQL `viewer.repositories` with `ownerAffiliations: OWNER`, ordered by `UPDATED_AT DESC`.
-- Fetches 50 repos per page and updates `totalCount` each time.
-- Prefetches the next page when your selection nears the end of the loaded list.
+- Fetches 15 repos per page by default (configurable via `REPOS_PER_FETCH` environment variable, 1-50).
+- Updates `totalCount` each time and prefetches the next page when selection nears the end of loaded list.
 
 ## Development
 
@@ -180,11 +223,14 @@ Scripts:
 pnpm build          # build to dist/
 pnpm build:binaries # build cross-platform binaries to ./binaries/
 pnpm dev            # watch mode
-pnpm start          # node dist/index.js
+pnpm start          # run normally
+pnpm start:debug    # run with debug mode enabled
+pnpm start:dev      # run with 5 repos per page and debug mode
 ```
 
-Notes:
-- In development mode (set `NODE_ENV=development` or `GH_MANAGER_DEV=1`), the app fetches 5 repos per page to speed iteration.
+Environment variables:
+- `REPOS_PER_FETCH`: Number of repositories to fetch per page (1-50, default: 15)
+- `GH_MANAGER_DEBUG=1`: Enables debug mode with performance metrics and detailed errors
 
 Project layout:
 - `src/index.tsx` — CLI entry and error handling
@@ -209,7 +255,7 @@ gh-manager-cli includes built-in Apollo Client caching to reduce GitHub API call
 
 Run with `GH_MANAGER_DEBUG=1` to enable debugging features:
 ```bash
-GH_MANAGER_DEBUG=1 npx gh-manager
+GH_MANAGER_DEBUG=1 npx gh-manager-cli
 ```
 
 Debug mode provides:
@@ -241,14 +287,20 @@ Even with caching enabled, API credits may decrease due to:
 - **Cache-and-network policy**: Updates stale cache data in background
 - **Sorting changes**: Different sort orders create new cache entries
 
-### Cache Configuration
+### Configuration
 
 ```bash
+# Number of repositories to fetch per page (1-50, default: 15)
+REPOS_PER_FETCH=10 npx gh-manager-cli
+
 # Custom cache TTL (milliseconds) - default: 30 minutes
-APOLLO_TTL_MS=1800000 npx gh-manager
+APOLLO_TTL_MS=1800000 npx gh-manager-cli
 
 # Enable debug mode to see cache performance
-GH_MANAGER_DEBUG=1 npx gh-manager
+GH_MANAGER_DEBUG=1 npx gh-manager-cli
+
+# Combine multiple environment variables
+REPOS_PER_FETCH=5 GH_MANAGER_DEBUG=1 npx gh-manager-cli-cli
 ```
 
 ## Troubleshooting
@@ -267,6 +319,8 @@ Recently implemented:
 - ✅ Organization support and switching (press `W`)
 - ✅ Enhanced server-side search with improved UX
 - ✅ Smart infinite scroll with 80% prefetch trigger
+- ✅ Modal-based sort and visibility filtering
+- ✅ Server-side visibility filtering for accurate pagination
 
 Highlights on deck:
 - Optional OS keychain storage via `keytar`

package/dist/{chunk-XCFI3TG5.js → chunk-75Y3BQBE.js}

@@ -118,7 +118,7 @@ async function fetchViewerOrganizations(client) {
   const res = await client(query);
   return res.viewer.organizations.nodes;
 }
-async function fetchViewerReposPage(client, first, after, orderBy, includeForkTracking = true, ownerAffiliations = ["OWNER"], organizationLogin) {
+async function fetchViewerReposPage(client, first, after, orderBy, includeForkTracking = true, ownerAffiliations = ["OWNER"], organizationLogin, privacy) {
   const sortField = orderBy?.field || "UPDATED_AT";
   const sortDirection = orderBy?.direction || "DESC";
   const isOrgContext = !!organizationLogin;
@@ -132,6 +132,7 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
         $sortField: RepositoryOrderField!
         $sortDirection: OrderDirection!
         $orgLogin: String!
+        $privacy: RepositoryPrivacy
       ) {
         rateLimit {
           limit
@@ -143,6 +144,7 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
             first: $first
             after: $after
             orderBy: { field: $sortField, direction: $sortDirection }
+            privacy: $privacy
           ) {
             totalCount
             pageInfo {
@@ -207,7 +209,8 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
       after: after ?? null,
       sortField,
       sortDirection,
-      orgLogin: organizationLogin
+      orgLogin: organizationLogin,
+      privacy: privacy ?? null
     });
     const data2 = res2.organization.repositories;
     return {
@@ -227,6 +230,7 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
       $sortField: RepositoryOrderField!
       $sortDirection: OrderDirection!
       $affiliations: [RepositoryAffiliation!]!
+      $privacy: RepositoryPrivacy
     ) {
       rateLimit {
         limit
@@ -239,6 +243,7 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
           first: $first
           after: $after
           orderBy: { field: $sortField, direction: $sortDirection }
+          privacy: $privacy
         ) {
           totalCount
           pageInfo {
@@ -303,7 +308,8 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
     after: after ?? null,
     sortField,
     sortDirection,
-    affiliations: ownerAffiliations
+    affiliations: ownerAffiliations,
+    privacy: privacy ?? null
   });
   const data = res.viewer.repositories;
   return {
@@ -314,7 +320,7 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
     rateLimit: res.rateLimit
   };
 }
-async function fetchViewerReposPageUnified(token, first, after, orderBy, includeForkTracking = true, fetchPolicy = "cache-first", ownerAffiliations = ["OWNER"], organizationLogin) {
+async function fetchViewerReposPageUnified(token, first, after, orderBy, includeForkTracking = true, fetchPolicy = "cache-first", ownerAffiliations = ["OWNER"], organizationLogin, privacy) {
   const isApolloEnabled = true;
   const debug = process.env.GH_MANAGER_DEBUG === "1";
   const isOrgContext = !!organizationLogin;
@@ -328,14 +334,14 @@ async function fetchViewerReposPageUnified(token, first, after, orderBy, include
       const sortField = orderBy?.field || "UPDATED_AT";
       const sortDirection = orderBy?.direction || "DESC";
       let q;
-      let variables = { first, after: after ?? null, sortField, sortDirection };
+      let variables = { first, after: after ?? null, sortField, sortDirection, privacy: privacy ?? null };
       if (isOrgContext) {
         variables.orgLogin = organizationLogin;
         q = ap.gql`
-          query OrgRepos($first: Int!, $after: String, $sortField: RepositoryOrderField!, $sortDirection: OrderDirection!, $orgLogin: String!) {
+          query OrgRepos($first: Int!, $after: String, $sortField: RepositoryOrderField!, $sortDirection: OrderDirection!, $orgLogin: String!, $privacy: RepositoryPrivacy) {
             rateLimit { limit remaining resetAt }
             organization(login: $orgLogin) {
-              repositories(first: $first, after: $after, orderBy: { field: $sortField, direction: $sortDirection }) {
+              repositories(first: $first, after: $after, orderBy: { field: $sortField, direction: $sortDirection }, privacy: $privacy) {
                 totalCount
                 pageInfo { endCursor hasNextPage }
                 nodes {
@@ -366,10 +372,10 @@ async function fetchViewerReposPageUnified(token, first, after, orderBy, include
       } else {
         variables.affiliations = ownerAffiliations;
         q = ap.gql`
-          query ViewerRepos($first: Int!, $after: String, $sortField: RepositoryOrderField!, $sortDirection: OrderDirection!, $affiliations: [RepositoryAffiliation!]!) {
+          query ViewerRepos($first: Int!, $after: String, $sortField: RepositoryOrderField!, $sortDirection: OrderDirection!, $affiliations: [RepositoryAffiliation!]!, $privacy: RepositoryPrivacy) {
             rateLimit { limit remaining resetAt }
             viewer {
-              repositories(ownerAffiliations: $affiliations, first: $first, after: $after, orderBy: { field: $sortField, direction: $sortDirection }) {
+              repositories(ownerAffiliations: $affiliations, first: $first, after: $after, orderBy: { field: $sortField, direction: $sortDirection }, privacy: $privacy) {
                 totalCount
                 pageInfo { endCursor hasNextPage }
                 nodes {
@@ -424,7 +430,7 @@ async function fetchViewerReposPageUnified(token, first, after, orderBy, include
   }
   if (debug) console.log("\u{1F4E1} Using Octokit fallback...");
   const octo = makeClient(token);
-  return fetchViewerReposPage(octo, first, after, orderBy, includeForkTracking, ownerAffiliations, organizationLogin);
+  return fetchViewerReposPage(octo, first, after, orderBy, includeForkTracking, ownerAffiliations, organizationLogin, privacy);
 }
 async function searchRepositoriesUnified(token, viewer, text, first, after, sortKey = "UPDATED_AT", sortDir = "DESC", includeForkTracking = true, fetchPolicy = "network-only") {
   const q = `${text} user:${viewer} in:name,description fork:true`;

package/dist/{github-6IFMCQKW.js → github-6OEBCAUZ.js}

@@ -17,7 +17,7 @@ import {
   updateCacheAfterArchive,
   updateCacheAfterDelete,
   updateCacheWithRepository
-} from "./chunk-XCFI3TG5.js";
+} from "./chunk-75Y3BQBE.js";
 export {
   archiveRepositoryById,
   deleteRepositoryRest,