feat(remote): Implement GitHub archive download with git clone fallback

.claude/commands/pr-review-request.md

@@ -0,0 +1 @@
+Please request a review of this pull request from Gemini and Coderabbit.

CLAUDE.md

@@ -223,6 +223,21 @@ This repository uses several automated review tools:
 - **Copilot Pull Request Reviewer**: GitHub's automated review suggestions
 - **Codecov**: Test coverage analysis and reporting
 
+### Requesting Additional Reviews
+You can request additional AI reviews manually:
+
+**CodeRabbit Review Request:**
+```
+@coderabbitai review
+```
+
+**Gemini Review Request:**
+```
+/gemini review
+```
+
+**Important**: Post each review request in separate comments for proper processing.
+
 ### Responding to Review Feedback
 
 **1. Address Technical Issues First:**

package.json

@@ -79,6 +79,7 @@
     "clipboardy": "^4.0.0",
     "commander": "^14.0.0",
     "fast-xml-parser": "^5.2.0",
+    "fflate": "^0.8.2",
     "git-url-parse": "^16.1.0",
     "globby": "^14.1.0",
     "handlebars": "^4.7.8",
@@ -98,12 +99,12 @@
     "zod": "^3.24.3"
   },
   "devDependencies": {
-    "git-up": "^8.1.1",
-    "@secretlint/types": "^9.3.4",
     "@biomejs/biome": "^1.9.4",
+    "@secretlint/types": "^9.3.4",
     "@types/node": "^22.14.1",
     "@types/strip-comments": "^2.0.4",
     "@vitest/coverage-v8": "^3.1.1",
+    "git-up": "^8.1.1",
     "rimraf": "^6.0.1",
     "secretlint": "^9.3.1",
     "tsx": "^4.19.4",

src/cli/actions/remoteAction.ts

@@ -3,8 +3,9 @@
 import path from 'node:path';
 import pc from 'picocolors';
 import { execGitShallowClone } from '../../core/git/gitCommand.js';
+import { downloadGitHubArchive, isArchiveDownloadSupported } from '../../core/git/gitHubArchive.js';
 import { getRemoteRefs } from '../../core/git/gitRemoteHandle.js';
-import { parseRemoteValue } from '../../core/git/gitRemoteParse.js';
+import { isGitHubRepository, parseGitHubRepoInfo, parseRemoteValue } from '../../core/git/gitRemoteParse.js';
 import { isGitInstalled } from '../../core/git/gitRepositoryHandle.js';
 import { RepomixError } from '../../shared/errorHandle.js';
 import { logger } from '../../shared/logger.js';
@@ -20,12 +21,103 @@
     execGitShallowClone,
     getRemoteRefs,
     runDefaultAction,
+    downloadGitHubArchive,
+    isGitHubRepository,
+    parseGitHubRepoInfo,
+    isArchiveDownloadSupported,
   },
 ): Promise<DefaultActionRunnerResult> => {
+  let tempDirPath = await createTempDirectory();
+  let result: DefaultActionRunnerResult;
+  let downloadMethod: 'archive' | 'git' = 'git';
+
+  try {
+    // Check if this is a GitHub repository and archive download is supported
+    const githubRepoInfo = deps.parseGitHubRepoInfo(repoUrl);
+    const shouldTryArchive = githubRepoInfo && deps.isArchiveDownloadSupported(githubRepoInfo);
+
+    if (shouldTryArchive) {
+      // Try GitHub archive download first
+      const spinner = new Spinner('Downloading repository archive...', cliOptions);
+
+      try {
+        spinner.start();
+
+        // Override ref with CLI option if provided
+        const repoInfoWithBranch = {
+          ...githubRepoInfo,
+          ref: cliOptions.remoteBranch ?? githubRepoInfo.ref,
+        };
+
+        await deps.downloadGitHubArchive(
+          repoInfoWithBranch,
+          tempDirPath,
+          {
+            timeout: 60000, // 1 minute timeout for large repos
+            retries: 2,
+          },
+          (progress) => {
+            if (progress.percentage !== null) {
+              spinner.update(`Downloading repository archive... (${progress.percentage}%)`);
+            } else {
+              // Show downloaded bytes when percentage is not available
+              const downloadedMB = (progress.downloaded / 1024 / 1024).toFixed(1);
+              spinner.update(`Downloading repository archive... (${downloadedMB} MB)`);
+            }
+          },
+        );
+
+        downloadMethod = 'archive';
+        spinner.succeed('Repository archive downloaded successfully!');
+        logger.log('');
+      } catch (archiveError) {
+        spinner.fail('Archive download failed, trying git clone...');
+        logger.trace('Archive download error:', (archiveError as Error).message);
+
+        // Clear the temp directory for git clone attempt
+        await cleanupTempDirectory(tempDirPath);
+        tempDirPath = await createTempDirectory();
+
+        // Fall back to git clone
+        await performGitClone(repoUrl, tempDirPath, cliOptions, deps);
+        downloadMethod = 'git';
+      }
+    } else {
+      // Use git clone directly
+      await performGitClone(repoUrl, tempDirPath, cliOptions, deps);
+      downloadMethod = 'git';
+    }
+
+    // Run the default action on the downloaded/cloned repository
+    result = await deps.runDefaultAction([tempDirPath], tempDirPath, cliOptions);
+    await copyOutputToCurrentDirectory(tempDirPath, process.cwd(), result.config.output.filePath);
+
+    logger.trace(`Repository obtained via ${downloadMethod} method`);
+  } finally {
+    // Cleanup the temporary directory
+    await cleanupTempDirectory(tempDirPath);
+  }
+
+  return result;
+};
+
+/**
+ * Performs git clone operation with spinner and error handling
+ */
+const performGitClone = async (
+  repoUrl: string,
+  tempDirPath: string,
+  cliOptions: CliOptions,
+  deps: {
+    isGitInstalled: typeof isGitInstalled;
+    getRemoteRefs: typeof getRemoteRefs;
+    execGitShallowClone: typeof execGitShallowClone;
+  },
+): Promise<void> => {
+  // Check if git is installed only when we actually need to use git
   if (!(await deps.isGitInstalled())) {
     throw new RepomixError('Git is not installed or not in the system PATH.');
   }
-
   // Get remote refs
   let refs: string[] = [];
   try {
@@ -39,8 +131,6 @@
   const parsedFields = parseRemoteValue(repoUrl, refs);
 
   const spinner = new Spinner('Cloning repository...', cliOptions);
-  const tempDirPath = await createTempDirectory();
-  let result: DefaultActionRunnerResult;
 
   try {
     spinner.start();
@@ -52,19 +142,10 @@
 
     spinner.succeed('Repository cloned successfully!');
     logger.log('');
-
-    // Run the default action on the cloned repository
-    result = await deps.runDefaultAction([tempDirPath], tempDirPath, cliOptions);
-    await copyOutputToCurrentDirectory(tempDirPath, process.cwd(), result.config.output.filePath);
   } catch (error) {
     spinner.fail('Error during repository cloning. cleanup...');
     throw error;
-  } finally {
-    // Cleanup the temporary directory
-    await cleanupTempDirectory(tempDirPath);
   }
-
-  return result;
 };
 
 export const createTempDirectory = async (): Promise<string> => {