browse-code 0.1.0__tar.gz → 0.1.3__tar.gz

{browse_code-0.1.0 → browse_code-0.1.3}/PKG-INFO

@@ -1,9 +1,9 @@
-Metadata-Version: 2.4
-Name: browse_code
-Version: 0.1.0
-Summary: A local AI bridge package
-Requires-Dist: fastapi
-Requires-Dist: uvicorn
-Requires-Dist: pydantic
-Dynamic: requires-dist
-Dynamic: summary
+Metadata-Version: 2.4
+Name: browse_code
+Version: 0.1.3
+Summary: A local AI bridge package
+Requires-Dist: fastapi
+Requires-Dist: uvicorn
+Requires-Dist: pydantic
+Dynamic: requires-dist
+Dynamic: summary

browse_code-0.1.3/README.md

@@ -0,0 +1,106 @@
+# Browse Code
+
+![PyPI version](https://badge.fury.io/py/browse-code.svg)
+![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+
+**Browse Code** is a CLI tool that turns any AI chatbot (ChatGPT, Gemini, Claude, HuggingFace) into an autonomous coding agent. It bridges your browser and local terminal, letting AI read/write files, run commands, and manage processes on your machine.
+
+## How It Works
+
+Browse Code has two parts:
+
+1. **A local server** that exposes your file system and terminal to the AI via a secure API.
+2. **A Chrome extension** that injects agent capabilities into AI chat interfaces.
+
+When connected, you can ask ChatGPT/Gemini/Claude to edit files, run scripts, search code, and more — all executed locally on your machine.
+
+## Setup
+
+### Step 1: Install the package
+
+```bash
+pip install browse-code
+```
+
+### Step 2: Run the CLI
+
+```bash
+bc
+```
+
+> If `bc` is not found, add your Python Scripts folder to PATH:
+> ```bash
+> # Windows (PowerShell)
+> $env:Path += ";$env:APPDATA\Python\Python312\Scripts"
+>
+> # Or run directly
+> python -m browse_code.cli
+> ```
+
+### Step 3: First-run extension setup
+
+On the first run, `bc` will guide you through a one-time Chrome extension setup:
+
+1. It asks for your permission to extract the extension files.
+2. It copies the extension to `~/.browse_code/extension/` and copies the path to your clipboard.
+3. It opens `chrome://extensions/` in your browser automatically.
+4. You enable **Developer mode** (top-right toggle), click **Load unpacked**, and paste the path.
+5. Press Enter in the terminal and the server starts.
+
+**You only do this once.** The extension stays loaded in Chrome across sessions.
+
+### Step 4: Start an AI session
+
+1. Open any supported AI chat (ChatGPT, Gemini, Claude, or HuggingFace Chat).
+2. Click the Browse Code Bridge extension icon and set your workspace directory.
+3. Click "Initialize Agent in Chat".
+4. Start coding with AI — it now has full access to your local environment.
+
+## Subsequent Usage
+
+After the first-time setup, just run:
+
+```bash
+bc
+```
+
+The server starts immediately. Open your AI chat tab and you're ready to go. The server terminal will show:
+- A startup banner with your workspace and endpoint
+- `[+] Extension connected` when the browser extension connects
+- Real-time logs of every file read, write, command execution, and diff
+
+## Features
+
+- **File Operations:** Read, write, and patch files with inline terminal diffs
+- **Code Search:** Search across your entire codebase by keyword
+- **Terminal Commands:** Run shell commands with full stdout/stderr capture
+- **Background Processes:** Start, monitor, and kill long-running processes
+- **Multi-Platform AI:** Works with ChatGPT, Gemini, Claude, and HuggingFace Chat
+- **Extension Heartbeat:** Server detects when the browser extension connects/disconnects
+
+## For Developers
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/Dedeep007/browse_code.git
+   cd browse_code
+   ```
+2. Install in editable mode:
+   ```bash
+   pip install -e .
+   ```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository.
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`).
+3. Commit your changes (`git commit -m 'Add some AmazingFeature'`).
+4. Push to the branch (`git push origin feature/AmazingFeature`).
+5. Open a Pull Request.
+
+## License
+
+Distributed under the MIT License.

browse_code-0.1.3/browse_code/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.3"

browse_code-0.1.3/browse_code/cli.py

@@ -0,0 +1,133 @@
+import os
+import sys
+import shutil
+import platform
+import subprocess
+import webbrowser
+from pathlib import Path
+
+
+def get_data_dir():
+    """Return ~/.browse_code, creating it if needed."""
+    data_dir = Path.home() / ".browse_code"
+    data_dir.mkdir(exist_ok=True)
+    return data_dir
+
+
+def copy_to_clipboard(text):
+    """Copy text to the system clipboard (cross-platform)."""
+    try:
+        system = platform.system()
+        if system == "Windows":
+            subprocess.run("clip", input=text.encode("utf-8"), check=True)
+        elif system == "Darwin":
+            subprocess.run("pbcopy", input=text.encode("utf-8"), check=True)
+        else:
+            # Linux — try xclip, fall back to xsel
+            try:
+                subprocess.run(
+                    ["xclip", "-selection", "clipboard"],
+                    input=text.encode("utf-8"),
+                    check=True,
+                )
+            except FileNotFoundError:
+                subprocess.run(
+                    ["xsel", "--clipboard", "--input"],
+                    input=text.encode("utf-8"),
+                    check=True,
+                )
+        return True
+    except Exception:
+        return False
+
+
+def setup_extension():
+    """First-time setup: extract extension, open Chrome, guide the user."""
+    data_dir = get_data_dir()
+    ext_dest = data_dir / "extension"
+    pkg_ext_dir = Path(__file__).parent / "extension"
+
+    print()
+    print("=" * 60)
+    print("  Browse Code - First Time Setup")
+    print("=" * 60)
+    print()
+    print("Browse Code needs a Chrome extension to connect your")
+    print("browser to the local server.")
+    print()
+
+    ans = input("Do you want to set up the extension now? (y/n): ")
+    if ans.strip().lower() != "y":
+        print("Skipped. You can re-run 'bc' anytime to set it up.")
+        return False
+
+    # Extract extension files
+    print()
+    print("Extracting extension files...")
+    if ext_dest.exists():
+        shutil.rmtree(ext_dest)
+    shutil.copytree(pkg_ext_dir, ext_dest)
+
+    ext_path_str = str(ext_dest)
+    print(f"  Extension extracted to: {ext_path_str}")
+    print()
+
+    # Copy path to clipboard
+    copied = copy_to_clipboard(ext_path_str)
+
+    # Open chrome://extensions
+    print("Opening Chrome extensions page...")
+    webbrowser.open("chrome://extensions/")
+
+    print()
+    print("-" * 60)
+    print("  QUICK SETUP (one-time, takes 30 seconds):")
+    print("-" * 60)
+    print('  1. Enable "Developer mode" toggle (top-right corner)')
+    print('  2. Click "Load unpacked"')
+    if copied:
+        print("  3. Paste the path (already copied to your clipboard)")
+    else:
+        print(f"  3. Select this folder: {ext_path_str}")
+    print("-" * 60)
+    print()
+
+    input("Press Enter after you've loaded the extension...")
+
+    # Mark as installed
+    marker = data_dir / ".installed"
+    marker.touch()
+
+    print()
+    print("Extension setup complete!")
+    return True
+
+
+def main():
+    data_dir = get_data_dir()
+    marker = data_dir / ".installed"
+
+    if not marker.exists():
+        result = setup_extension()
+        if not result:
+            return
+
+    print()
+    print("=" * 60)
+    print("  Browse Code")
+    print("=" * 60)
+    print()
+    print("Starting server...")
+    print()
+
+    try:
+        from .server import app
+    except ImportError:
+        from server import app
+
+    import uvicorn
+    uvicorn.run(app, host="127.0.0.1", port=5505, access_log=False)
+
+
+if __name__ == "__main__":
+    main()