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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: browse_code
-Version: 0.1.0
+Version: 0.1.1
 Summary: A local AI bridge package
 Requires-Dist: fastapi
 Requires-Dist: uvicorn

{browse_code-0.1.0 → browse_code-0.1.1}/README.md

@@ -1,17 +1,18 @@
 # 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 powerful CLI tool that bridges your local terminal environment with your browser. It runs a local backend server and injects an AI-assisted Chrome extension, enabling seamless automation, local file reads/writes, and background process management directly from the browser.
 
-## ✨ Features
+## Features
 
 - **Local AI Bridge Server:** A fast, secure FastAPI-based server that exposes your local environment (reading files, listing directories, executing terminal commands, managing background processes).
 - **Chrome Extension Integration:** Automatically sets up (with your permission) a Chrome extension that interacts with the backend.
 - **Easy-to-use CLI:** Start your AI sessions with a single `bc` command.
 
-## 🚀 Installation
+## Installation
 
 ### For Users
 
@@ -20,7 +21,6 @@ Install the package directly via pip:
 ```bash
 pip install browse-code
 ```
-*(Note: If this package is published to PyPI, you can install it as above. Otherwise, clone the repo and see "For Developers" below).*
 
 ### For Developers
 
@@ -34,7 +34,7 @@ pip install browse-code
    pip install -e .
    ```
 
-## 💻 Usage
+## Usage
 
 Once installed, simply run the CLI command:
 
@@ -43,10 +43,18 @@ bc
 ```
 
 ### What happens when you run `bc`?
-1. **Extension Setup:** The tool will ask if you want to install its companion Chrome extension. If you agree, it will extract the extension to your home folder (`~/.browse_code/extension`) and offer to launch Chrome with the extension loaded.
-2. **Server Initialization:** It will start the AI session backend server on `http://127.0.0.1:5505`. Keep this terminal open to maintain the bridge connection and view real-time execution logs and diffs.
 
-## 🤝 Contributing
+**First run:**
+1. The CLI asks if you want to set up the Chrome extension.
+2. If you agree, it extracts the extension to `~/.browse_code/extension/` and copies the path to your clipboard.
+3. It opens `chrome://extensions/` automatically.
+4. You just need to enable "Developer mode", click "Load unpacked", and paste the path.
+5. Once done, press Enter and the server starts.
+
+**Every run after that:**
+The server starts immediately with no prompts. The extension stays loaded in Chrome across sessions.
+
+## Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request.
 
@@ -56,6 +64,6 @@ Contributions are welcome! Please feel free to submit a Pull Request.
 4. Push to the branch (`git push origin feature/AmazingFeature`).
 5. Open a Pull Request.
 
-## 📄 License
+## License
 
 Distributed under the MIT License.

browse_code-0.1.1/browse_code/__init__.py

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

browse_code-0.1.1/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()

{browse_code-0.1.0 → browse_code-0.1.1}/browse_code/extension/content.js

@@ -38,6 +38,13 @@ spoofScript.src = chrome.runtime.getURL('spoof.js');
 (document.head || document.documentElement).appendChild(spoofScript);
 spoofScript.onload = function () { this.remove(); };
 
+// Heartbeat: ping the server every 5 seconds so it knows the extension is connected
+function pingServer() {
+    fetch(`${LOCAL_SERVER}/extension/ping`).catch(() => {});
+}
+pingServer();
+setInterval(pingServer, 5000);
+
 const SYSTEM_PROMPT = `You are an elite, autonomous AI software engineer (similar to Antigravity or Devin) connected to a local execution bridge.
 You do NOT have direct access to my file system. You interact with it ONLY by emitting the XML tool tags defined below, which are executed locally on my machine.
 

{browse_code-0.1.0 → browse_code-0.1.1}/browse_code/extension/manifest.json

@@ -1,6 +1,6 @@
 {
   "manifest_version": 3,
-  "name": "Local Agent Bridge",
+  "name": "Browse Code Bridge",
   "version": "2.0",
   "description": "Autonomous AI Code Execution Bridge",
   "permissions": [

{browse_code-0.1.0 → browse_code-0.1.1}/browse_code/extension/popup.js

@@ -24,7 +24,7 @@ document.addEventListener('DOMContentLoaded', () => {
         }
         chrome.storage.local.set({ workspaceDir: path, injectN: injectN });
         syncWithServer(path);
-        saveBtn.innerText = '✅ Saved!';
+        saveBtn.innerText = 'Saved!';
         setTimeout(() => saveBtn.innerText = 'Save Directory', 2000);
     });
 
@@ -37,20 +37,20 @@ document.addEventListener('DOMContentLoaded', () => {
             if (activeTab && validUrls.some(url => activeTab.url.includes(url))) {
                 chrome.tabs.sendMessage(activeTab.id, { action: "INITIALIZE_AGENT" }, () => {
                     if (chrome.runtime.lastError) {
-                        initBtn.innerText = '❌ Error: Refresh Tab First!';
-                        setTimeout(() => initBtn.innerText = '✨ Initialize Agent in Chat', 3000);
+                        initBtn.innerText = 'Error: Refresh Tab First!';
+                        setTimeout(() => initBtn.innerText = 'Initialize Agent in Chat', 3000);
                     } else {
-                        initBtn.innerText = '✨ Initialize Agent in Chat';
+                        initBtn.innerText = 'Initialize Agent in Chat';
                     }
                 });
             } else {
-                initBtn.innerText = '❌ Not a valid AI chat tab';
-                setTimeout(() => initBtn.innerText = '✨ Initialize Agent in Chat', 3000);
+                initBtn.innerText = 'Not a valid AI chat tab';
+                setTimeout(() => initBtn.innerText = 'Initialize Agent in Chat', 3000);
             }
         });
     });
 
-    function saveWorkspace(path) {
+    function syncWithServer(path) {
         fetch('http://127.0.0.1:5505/set-workspace', {
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
@@ -60,7 +60,7 @@ document.addEventListener('DOMContentLoaded', () => {
         });
     }
 
-    function updateStatus() {
+    function pollStatus() {
         fetch('http://127.0.0.1:5505/status')
             .then(res => res.json())
             .then(data => {

{browse_code-0.1.0 → browse_code-0.1.1}/browse_code/server.py

@@ -114,6 +114,11 @@ def print_startup_banner(workspace: str, host: str, port: int):
     ep_text = f" Endpoint   http://{host}:{port}"
     ep_pad = max(0, width - len(ep_text))
     print(f"{C_HEADER}│{C_RESET} {C_MUTED}Endpoint {C_RESET}  http://{host}:{port}{' ' * ep_pad}{C_HEADER}│{C_RESET}")
+    ext_label = "Extension"
+    ext_status = "Waiting for connection..."
+    ext_text = f" {ext_label}  {ext_status}"
+    ext_pad = max(0, width - len(ext_text))
+    print(f"{C_HEADER}│{C_RESET} {C_MUTED}{ext_label}{C_RESET}  {C_WARN}{ext_status}{C_RESET}{' ' * ext_pad}{C_HEADER}│{C_RESET}")
     print(f"{C_HEADER}╰{'─' * width}╯{C_RESET}")
     print()
 
@@ -121,6 +126,24 @@ def print_startup_banner(workspace: str, host: str, port: int):
 WORKSPACE_DIR = r"C:\Users\dedeep vasireddy\Downloads\test"
 BACKGROUND_PROCESSES = {}
 
+# Extension heartbeat tracking
+_last_extension_ping = None
+_HEARTBEAT_TIMEOUT = 10  # seconds — extension is "connected" if pinged within this window
+
+def is_extension_connected():
+    if _last_extension_ping is None:
+        return False
+    return (time.time() - _last_extension_ping) < _HEARTBEAT_TIMEOUT
+
+@app.get("/extension/ping")
+async def extension_ping():
+    global _last_extension_ping
+    was_connected = is_extension_connected()
+    _last_extension_ping = time.time()
+    if not was_connected:
+        print(f"\n{C_OK}[+] Extension connected{C_RESET}")
+    return {"status": "ok"}
+
 def cleanup_background_processes():
     print(f"\n{C_WARN}⏻  Shutting down — cleaning up background processes...{C_RESET}")
     for pid, data in BACKGROUND_PROCESSES.items():
@@ -150,7 +173,8 @@ async def request_logger(request: Request, call_next):
 
     # The /extension/run-tool endpoint already prints its own detailed
     # banner + result, so skip the generic line there to avoid duplication.
-    if request.url.path != "/extension/run-tool":
+    # Also skip /extension/ping to avoid flooding the log with heartbeats.
+    if request.url.path not in ("/extension/run-tool", "/extension/ping"):
         print(f"{C_DIM}→{C_RESET} {request.method} {request.url.path}  "
               f"{color}{status}{C_RESET}  {C_DIM}{elapsed_ms:.0f}ms{C_RESET}")
 

{browse_code-0.1.0 → browse_code-0.1.1}/browse_code.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: browse_code
-Version: 0.1.0
+Version: 0.1.1
 Summary: A local AI bridge package
 Requires-Dist: fastapi
 Requires-Dist: uvicorn

{browse_code-0.1.0 → browse_code-0.1.1}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="browse_code",
-    version="0.1.0",
+    version="0.1.1",
     description="A local AI bridge package",
     packages=find_packages(),
     include_package_data=True,

browse_code-0.1.0/browse_code/__init__.py

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

browse_code-0.1.0/browse_code/cli.py

@@ -1,75 +0,0 @@
-import os
-import sys
-import shutil
-import subprocess
-from pathlib import Path
-
-def get_data_dir():
-    home = Path.home()
-    data_dir = home / ".browse_code"
-    data_dir.mkdir(exist_ok=True)
-    return data_dir
-
-def install_extension():
-    data_dir = get_data_dir()
-    installed_marker = data_dir / ".installed"
-    ext_dest = data_dir / "extension"
-
-    # Copy extension files from package to ~/.browse_code/extension
-    pkg_ext_dir = Path(__file__).parent / "extension"
-    
-    if not installed_marker.exists():
-        ans_allow = input("Do you allow browse_code to install its Chrome extension? (y/n): ")
-        if ans_allow.lower() != 'y':
-            print("Extension installation skipped.")
-            return
-
-        print("Installing browse_code extension...")
-        if ext_dest.exists():
-            shutil.rmtree(ext_dest)
-        shutil.copytree(pkg_ext_dir, ext_dest)
-        
-        print("\n========================================================")
-        print("Extension files copied to: ", ext_dest)
-        print("To load the extension in Chrome:")
-        print("1. Open Chrome and navigate to chrome://extensions/")
-        print("2. Enable 'Developer mode' at the top right")
-        print("3. Click 'Load unpacked' and select the folder:")
-        print(f"   {ext_dest}")
-        print("========================================================\n")
-        
-        ans = input("Do you want me to try launching Chrome with this extension now? (y/n): ")
-        if ans.lower() == 'y':
-            # Attempt to launch chrome
-            # On Windows:
-            chrome_path = r"C:\Program Files\Google\Chrome\Application\chrome.exe"
-            if not os.path.exists(chrome_path):
-                chrome_path = r"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe"
-            if os.path.exists(chrome_path):
-                subprocess.Popen([chrome_path, f"--load-extension={ext_dest}"])
-            else:
-                print("Could not find Chrome executable automatically.")
-        
-        installed_marker.touch()
-    else:
-        # Already installed, check if files are still there, if not recopy
-        if not ext_dest.exists():
-            shutil.copytree(pkg_ext_dir, ext_dest)
-
-def main():
-    install_extension()
-    
-    print("\nStarting AI session server...\n")
-    # Now we need to start the FastAPI server.
-    # The original server.py is in the same package
-    try:
-        from .server import app
-    except ImportError:
-        # Fallback if run directly during dev
-        from server import app
-        
-    import uvicorn
-    uvicorn.run(app, host="127.0.0.1", port=5505, access_log=False)
-
-if __name__ == "__main__":
-    main()