Merge branch 'main' of github.com:epilande/codegrab

Author: epilande

.gitignore

@@ -1,5 +1,8 @@
 .DS_Store
-
 *.log
+*.prof
+*.pprof
 bin/
 dist/
+perf_results/
+/grab

README.md

@@ -29,7 +29,8 @@ to your clipboard, ready for LLM processing.
 - 🌲 **Directory Tree View**: Display a tree-style view of your project structure
 - 🧮 **Token Estimation**: Get estimated token count for LLM context windows
 - 🛡️ **Secret Detection & Redaction**: Uses [gitleaks](https://github.com/gitleaks/gitleaks) to identify potential secrets and prevent sharing sensitive information
-- 🔗 **Dependency Resolution**: Automatically include dependencies for Go, JS/TS when using the `--deps` flag
+- 🔗 **Dependency Resolution**: Automatically include dependencies for Go, JS/TS, Python when using the `--deps` flag
+- 🌐 **Remote Git Repo Support**: Analyze remote repositories by passing Git URLs (supports GitHub, GitLab, Bitbucket, SSH, HTTPS)
 
 ## 📦 Installation
 
@@ -84,9 +85,10 @@ grab [options] [directory]
 
 ### Arguments
 
-| Argument    | Description                                           |
-| :---------- | :---------------------------------------------------- |
-| `directory` | Optional path to the project directory (default: ".") |
+| Argument    | Description                                                                     |
+| :---------- | :------------------------------------------------------------------------------ |
+| `directory` | Optional path to the project directory (default: ".")                           |
+| `git-url`   | Git repository URL (GitHub, GitLab, Bitbucket, SSH, HTTPS) to clone and analyze |
 
 ### Options
 
@@ -157,6 +159,24 @@ grab [options] [directory]
    grab -g="*.{ts,tsx}" -g="\!*.spec.{ts,tsx}"
    ```
 
+9. Analyze a remote Git repository:
+
+   ```bash
+   grab https://github.com/user/repo.git
+   ```
+
+10. Analyze a remote repository non-interactively with dependencies:
+
+    ```bash
+    grab -n --deps https://github.com/user/repo.git
+    ```
+
+11. Clone and analyze using SSH:
+
+    ```bash
+    grab git@github.com:user/repo.git
+    ```
+
 ## ⌨️ Keyboard Controls
 
 ### Navigation
@@ -210,6 +230,7 @@ CodeGrab can automatically include dependencies for selected files, making it ea
 - **Supported Languages**:
   - **Go**: Resolves relative imports and project-local module imports (if `go.mod` is present).
   - **JavaScript/TypeScript**: Resolves relative imports/requires for `.js`, `.jsx`, `.ts`, and `.tsx` files, including directory `index` files.
+  - **Python**: Resolves relative imports for `.py` files within the project structure.
 - **Enabling**:
   - **Interactive Mode**: Press <kbd>D</kbd> to toggle dependency resolution on/off. A `🔗 Deps` indicator will appear in the footer when active. Files added as dependencies will be marked with `[dep]`.
   - **Non-Interactive Mode**: Use the `--deps` flag.
@@ -220,6 +241,19 @@ CodeGrab can automatically include dependencies for selected files, making it ea
 
 ![codegrab-deps](https://github.com/user-attachments/assets/db04805c-a0b0-4249-ab48-da3d7b92000c)
 
+## 🌐 Git Repository Support
+
+CodeGrab can directly analyze remote Git repositories without requiring manual cloning. Simply pass a Git URL as the directory argument, and CodeGrab will automatically clone the repository to a temporary directory.
+
+- **Supported URL Formats**:
+  - HTTPS: `https://github.com/user/repo.git` or `https://github.com/user/repo`
+  - SSH: `git@github.com:user/repo.git`
+  - SSH with protocol: `ssh://git@github.com/user/repo.git`
+  - Supports GitHub, GitLab, Bitbucket, and other Git hosting platforms
+- **Efficient Cloning**: Uses shallow cloning (`--depth=1`) to only fetch the latest commit, making it fast and lightweight
+- **Automatic Cleanup**: Temporary directories are automatically cleaned up after processing
+- **Full Feature Support**: All CodeGrab features work with remote repositories (filtering, dependency resolution, secret detection, etc.)
+
 ## 🛡️ Secret Detection & Redaction
 
 CodeGrab automatically scans the content of selected files for potential secrets using [gitleaks](https://github.com/gitleaks/gitleaks) with its default rules. This helps prevent accidental exposure of sensitive credentials like API keys, private tokens, and passwords.

cmd/grab/main.go

@@ -14,6 +14,7 @@ import (
 	"github.com/epilande/codegrab/internal/filesystem"
 	"github.com/epilande/codegrab/internal/generator"
 	"github.com/epilande/codegrab/internal/generator/formats"
+	"github.com/epilande/codegrab/internal/git"
 	"github.com/epilande/codegrab/internal/model"
 	"github.com/epilande/codegrab/internal/ui"
 	"github.com/epilande/codegrab/internal/ui/themes"
@@ -77,7 +78,7 @@ func main() {
 	flag.StringVar(&formatName, "format", "markdown", formatUsage)
 	flag.StringVar(&formatName, "f", "markdown", formatUsage+" (shorthand)")
 
-	flag.BoolVar(&resolveDeps, "deps", false, "Automatically include direct dependencies (Go, TS/JS)")
+	flag.BoolVar(&resolveDeps, "deps", false, "Automatically include direct dependencies (Go, TS/JS, Python)")
 
 	flag.IntVar(&maxDepth, "max-depth", 1, "Maximum depth for dependency resolution (-1 for unlimited)")
 
@@ -126,15 +127,44 @@ func main() {
 
 	// Use current directory if no argument is provided
 	root := "."
+	var cleanup func()
+	var isGitRepo bool
+
 	if flag.NArg() > 0 {
-		root = flag.Arg(0)
+		arg := flag.Arg(0)
+
+		// Check if the argument is a Git URL
+		if git.IsGitURL(arg) {
+			fmt.Printf("🔄 Cloning repository: %s\n", arg)
+
+			clonedPath, cleanupFunc, err := git.CloneRepository(arg)
+			if err != nil {
+				log.Fatalf("Error cloning repository: %v", err)
+			}
+
+			root = clonedPath
+			cleanup = cleanupFunc
+			isGitRepo = true
+
+			fmt.Printf("✅ Repository cloned to: %s\n", root)
+		} else {
+			root = arg
+		}
 	}
 
-	absRoot, err := filepath.Abs(root)
-	if err != nil {
-		log.Fatalf("Error getting absolute path for %q: %v", root, err)
+	// Set up cleanup for Git repositories
+	if cleanup != nil {
+		defer cleanup()
+	}
+
+	// Convert to absolute path for local directories
+	if !isGitRepo {
+		absRoot, err := filepath.Abs(root)
+		if err != nil {
+			log.Fatalf("Error getting absolute path for %q: %v", root, err)
+		}
+		root = absRoot
 	}
-	root = absRoot
 
 	// Validate the provided path
 	if stat, err := os.Stat(root); err != nil {

go.sum

@@ -27,8 +27,6 @@ github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSs
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc h1:U9qPSI2PIWSS1VwoXQT9A3Wy9MM3WgvqSxFWenqJduM=
 github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/epilande/go-devicons v0.0.0-20250430064519-26ca6d272b4c h1:ZKFmMr4EQ+6wni8gHq56tEmjMdIDySQ+zFgwXi+yCgc=
-github.com/epilande/go-devicons v0.0.0-20250430064519-26ca6d272b4c/go.mod h1:myBNrCUxmCh3ktYaRUMfL8epmWMBu6/yj0JFnQHYFSU=
 github.com/epilande/go-devicons v0.0.0-20250502062109-89b44a507be9 h1:wu8xPucxiGFKrSN24fE9VVzjthnfVqYFx33bNoRL8DU=
 github.com/epilande/go-devicons v0.0.0-20250502062109-89b44a507be9/go.mod h1:myBNrCUxmCh3ktYaRUMfL8epmWMBu6/yj0JFnQHYFSU=
 github.com/erikgeiser/coninput v0.0.0-20211004153227-1c3628e74d0f h1:Y/CXytFA4m6baUTXGLOoWe4PQhGxaX0KpnayAqC48p4=