gh-manager-cli 1.4.1 → 1.5.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [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)
+
+
+### Bug Fixes
+
+* add packages permission and improve GitHub Packages publishing with jq ([2346944](https://github.com/wiiiimm/gh-manager-cli/commit/2346944739f70d237240c6d67ae39c32d1d623d5))
+
 ## [1.4.1](https://github.com/wiiiimm/gh-manager-cli/compare/v1.4.0...v1.4.1) (2025-08-31)
 
 

package/README.md

@@ -2,11 +2,32 @@
 
 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
-# Run with npx (no installation required)
-npx gh-manager-cli
+# Run with npx (no install)
+npx gh-manager
 ```
 
 On first run, you'll be prompted for a GitHub Personal Access Token.
@@ -20,13 +41,14 @@ 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**:
-  - Open in browser (Enter/`o`)
-  - Delete repository (`Del`/Backspace) with secure two-step confirmation
-  - Archive/unarchive repositories (`a`) with confirmation prompts
+  - 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, `g`/`G`)
-- **Display Density**: Toggle between compact/cozy/comfy spacing (`t`)
+- **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
 - **Loading States**: Contextual loading screens for sorting and refreshing operations
 - **Rate Limit Monitoring**: Live API usage display with visual warnings
@@ -45,11 +67,7 @@ On first run, you'll be prompted for a GitHub Personal Access Token.
 Run instantly without installing:
 
 ```bash
-# From NPM registry (clean, fast)
-npx gh-manager-cli
-
-# From GitHub (always latest)
-npx github:wiiiimm/gh-manager-cli
+npx gh-manager
 ```
 
 ### NPM Global Install
@@ -128,6 +146,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`

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.1",
+      version: "1.5.0",
       private: false,
       description: "Interactive CLI to manage your GitHub repos (personal) with Ink",
       license: "MIT",
@@ -252,6 +252,7 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
             parent {
               nameWithOwner
               defaultBranchRef {
+                name
                 target {
                   ... on Commit {
                     history(first: 0) {
@@ -262,6 +263,7 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
               }
             }
             defaultBranchRef {
+              name
               target {
                 ... on Commit {
                   history(first: 0) {
@@ -272,7 +274,9 @@ async function fetchViewerReposPage(client, first, after, orderBy, includeForkTr
             }` : `
             parent {
               nameWithOwner
-            }`}
+            }
+            defaultBranchRef { name }
+            `}
           }
         }
       }
@@ -677,7 +681,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 {

package/package.json

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