@aigne/example-afs-git 1.1.0-beta → 1.2.0-beta

package/README.md

@@ -43,9 +43,12 @@ export OPENAI_API_KEY=YOUR_OPENAI_API_KEY
 # Mount current Git repository (read-only by default)
 npx -y @aigne/example-afs-git --interactive
 
-# Mount a specific repository
+# Mount a specific local repository
 npx -y @aigne/example-afs-git --path /path/to/repo --interactive
 
+# Mount a remote Git repository
+npx -y @aigne/example-afs-git --url https://github.com/user/repo.git --interactive
+
 # Ask a specific question
 npx -y @aigne/example-afs-git --input "What files changed in the last commit on main?"
 
@@ -139,9 +142,12 @@ pnpm install
 # Run with current repository (read-only by default)
 pnpm start
 
-# Run with a specific repository
+# Run with a specific local repository
 pnpm start --path /path/to/repo
 
+# Run with a remote repository
+pnpm start --url https://github.com/user/repo.git
+
 # Run in interactive chat mode
 pnpm start --interactive
 
@@ -159,13 +165,16 @@ pnpm start --access-mode readwrite --interactive
 
 | Option | Description | Default | Example |
 |--------|-------------|---------|---------|
-| `--path` | Path to the git repository | Current directory | `--path /path/to/repo` |
+| `--path` | Path to the local git repository | Current directory | `--path /path/to/repo` |
+| `--url` | URL of remote git repository (clones automatically) | - | `--url https://github.com/user/repo.git` |
 | `--branches` | Comma-separated list of branches to access | All branches | `--branches main,develop` |
 | `--access-mode` | Access mode: `readonly` or `readwrite` | `readonly` | `--access-mode readwrite` |
 | `--auto-commit` | Automatically commit changes (requires `readwrite` mode) | `false` | `--auto-commit` |
 | `--interactive` | Run in interactive chat mode | `false` | `--interactive` |
 | `--input` | Single question to ask | - | `--input "What branches exist?"` |
 
+**Note:** Either `--path` or `--url` must be provided. When using `--url`, the repository is cloned to a temporary directory automatically.
+
 ## How It Works: 3 Simple Steps
 
 ### 1. Create AFSGit Module
@@ -173,11 +182,19 @@ pnpm start --access-mode readwrite --interactive
 ```typescript
 import { AFSGit } from "@aigne/afs-git";
 
+// Option 1: Mount a local repository
 const afsGit = new AFSGit({
   repoPath: process.cwd(),
   accessMode: 'readonly',  // or 'readwrite' for modifications
   branches: ['main', 'develop']  // optional: limit branches
 });
+
+// Option 2: Clone and mount a remote repository
+const afsGitRemote = new AFSGit({
+  remoteUrl: 'https://github.com/user/repo.git',
+  branches: ['main'],  // single branch = optimized clone
+  depth: 1,  // shallow clone (faster)
+});
 ```
 
 ### 2. Mount It as an AFS Module
@@ -234,6 +251,9 @@ npx -y @aigne/example-afs-git --input "Find all TODO comments in the main branch
 # Code review
 npx -y @aigne/example-afs-git --input "Review the authentication code in src/auth/"
 
+# Explore a remote repository
+npx -y @aigne/example-afs-git --url https://github.com/octocat/Hello-World.git --input "What's in this repository?"
+
 # Interactive mode - ask follow-up questions
 npx -y @aigne/example-afs-git --interactive
 ```
@@ -248,6 +268,18 @@ npx -y @aigne/example-afs-git --interactive
 
 ## Use Cases
 
+### Explore Remote Repositories
+Analyze any public GitHub repository without cloning manually:
+```typescript
+const afs = new AFS()
+  .mount(new AFSGit({
+    remoteUrl: 'https://github.com/octocat/Hello-World.git',
+    branches: ['master'],  // single branch for fast clone
+    depth: 1  // shallow clone
+  }));
+// Ask: "What's the structure of this repository?"
+```
+
 ### Code Review Assistance
 Let AI help review code across branches:
 ```typescript
@@ -324,6 +356,18 @@ const afs = new AFS()
 
 ## Advanced Features
 
+### Remote Repository Cloning
+Automatically clone and mount remote repositories:
+```typescript
+const afsGit = new AFSGit({
+  remoteUrl: 'https://github.com/user/repo.git',
+  branches: ['main'],  // Single branch = --single-branch optimization
+  depth: 1,  // Shallow clone for faster setup
+  repoPath: './cache/repo'  // Optional: specify clone location
+});
+// Without repoPath, clones to temp directory automatically
+```
+
 ### Branch Filtering
 Only expose specific branches:
 ```typescript

package/index.ts

@@ -11,7 +11,10 @@ const argv = yargs()
   .option("path", {
     type: "string",
     describe: "Path to the git repo to mount",
-    default: ".",
+  })
+  .option("url", {
+    type: "string",
+    describe: "URL of the remote git repository",
   })
   .option("description", {
     type: "string",
@@ -29,17 +32,20 @@ const argv = yargs()
     default: false,
     describe: "Automatically commit changes to the mounted repo",
   })
-  .demandOption("path")
   .strict(false)
   .parseSync(process.argv);
 
+// Default to current directory if neither path nor url is provided
+const repoPath = argv.path || (argv.url ? undefined : ".");
+
 const aigne = await loadAIGNEWithCmdOptions();
 
 const afs = new AFS()
   .mount(new AFSHistory({ storage: { url: ":memory:" } })) // In-memory history for this example
   .mount(
     new AFSGit({
-      repoPath: argv.path,
+      repoPath: argv.url ? undefined : repoPath,
+      remoteUrl: argv.url,
       description: argv.description,
       accessMode: argv.accessMode as AFSAccessMode,
       autoCommit: argv.autoCommit,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/example-afs-git",
-  "version": "1.1.0-beta",
+  "version": "1.2.0-beta",
   "description": "A demonstration of using AIGNE Framework with AFS git module",
   "author": "Arcblock <blocklet@arcblock.io> https://github.com/blocklet",
   "homepage": "https://github.com/AIGNE-io/aigne-framework/tree/main/examples/afs-git",
@@ -17,15 +17,15 @@
   ],
   "dependencies": {
     "yargs": "^18.0.0",
-    "@aigne/afs": "^1.4.0-beta.11",
-    "@aigne/afs-history": "^1.2.0-beta.12",
-    "@aigne/afs-git": "^1.1.0-beta",
-    "@aigne/cli": "^1.59.0-beta.31",
-    "@aigne/core": "^1.72.0-beta.25"
+    "@aigne/afs": "^1.4.0",
+    "@aigne/afs-history": "^1.3.0-beta",
+    "@aigne/afs-git": "^1.2.0-beta",
+    "@aigne/core": "^1.73.0-beta",
+    "@aigne/cli": "^1.60.0-beta"
   },
   "devDependencies": {
     "@types/bun": "^1.2.22",
-    "@aigne/test-utils": "^0.5.69-beta.25"
+    "@aigne/test-utils": "^0.5.70-beta"
   },
   "scripts": {
     "start": "bun run index.ts",