Skip to main content

Browse Code

Browse Code

PyPI - Version Downloads Python Version License

Browse Code is a powerful CLI tool and browser extension that turns any web-based AI chatbot (ChatGPT, Gemini, Claude, HuggingFace) into a fully autonomous coding agent (similar to Devin or Antigravity) running right on your local machine.

Stop copy-pasting code back and forth! Browse Code bridges your browser and local terminal, granting your favorite AI the ability to securely read files, execute true regex searches, surgically replace code, and run terminal commands directly in your workspace.

Tool Formatting Example


Why Browse Code?

  • 100% Free Autonomous Agents: Leverage the free tiers of powerful models like Claude 3.5 Sonnet or Gemini 1.5 Pro to build entire projects autonomously without paying for expensive agent services.
  • Local & Secure: Your code stays on your machine. The AI only reads what it searches for.
  • Seamless Integration: Works out-of-the-box with ChatGPT, Claude, Gemini, and HuggingFace Chat.
  • Advanced Tooling: Features true regex codebase searching, precise line-based surgical edits, and asynchronous background process monitoring.

How is this different from Claude Code / Cursor / Devin?

Most autonomous coding tools (like Claude Code, Cursor, or Devin) are API-based. This means you must provide your own API keys, and you pay per token for every single file read, search, and edit. Over a long coding session, this can easily cost dollars per hour!

Browse Code is entirely different. It operates purely via a Chrome Extension that injects agentic workflows directly into the native web UI of ChatGPT, Gemini, or Claude.

This means you don't need ANY API keys! It hijacks your existing free or Plus subscription and turns the standard web chat into a fully integrated, local execution environment for free.


How It Works

Browse Code consists of two tightly integrated components:

  1. A Local Python Server (bc): Exposes your file system and terminal to the AI via a secure local API.
  2. A Chrome Extension: Injects agent capabilities and hidden tools directly into the AI chat interface, passing messages back and forth flawlessly.

Quick Setup

Step 1: Install the Package

pip install browse-code

Step 2: Run the CLI

You can run the server from anywhere on your machine:

bc

Note: If bc is not found, add your Python Scripts folder to PATH, or run directly via python -m browse_code.cli.

Step 3: First-Run Extension Setup (One-Time)

On your very first run, bc will guide you through a simple Chrome extension setup: For Chrome / Edge / Brave / Chromium:

  1. It automatically extracts the extension to ~/.browse_code/extension_chrome/ and copies the path to your clipboard.
  2. It opens chrome://extensions/ in your browser.
  3. Enable Developer mode (top-right), click Load unpacked, and paste the path.

For Firefox / LibreWolf / Waterfox:

  1. Open about:debugging in your URL bar.
  2. Click This Firefox on the left menu.
  3. Click Load Temporary Add-on...
  4. Navigate to ~/.browse_code/extension_firefox/ and select the manifest.json file.

Press Enter in your terminal. You're done!

Step 4: Start Coding Autonomously

  1. Open any supported AI chat (ChatGPT, Gemini, Claude, or HuggingFace Chat).
  2. Click the Browse Code Bridge extension icon (the puzzle piece) in your browser toolbar.
  3. Paste the Authentication Key shown in your bc terminal into the extension popup.
  4. Set your desired workspace directory in the popup.
  5. Click Initialize Agent in Chat.
  6. Give the AI a task (e.g., "Build a React Native app that syncs gallery photos") and watch it work entirely on its own!

Core Capabilities

  • Directory Exploration (view_dir): The AI can map out your project structure.
  • True Regex Search (search_code): Blazing fast codebase search using compiled Python regex.
  • Surgical Reading (read_lines): Reads specific chunks of files to preserve LLM token context.
  • Precise Editing (replace / write): Surgically replaces specific code blocks using start/end line bounds to eliminate hallucination, complete with beautiful inline terminal diffs!
  • Terminal Execution (terminal_run): Runs synchronous shell commands with full stdout/stderr capture (e.g., git commit, ls).
  • Background Processes (terminal_bg): Starts and monitors long-running dev servers or build scripts (e.g., npm run dev) asynchronously.

For Developers

Want to contribute or hack on Browse Code?

  1. Clone the repository:
    git clone https://github.com/Dedeep007/browse_code.git
    cd browse_code
    
  2. Install in editable mode:
    pip install -e .
    

Contributions are always welcome! Feel free to open a Pull Request.


License

Distributed under the MIT License.

Metadata

Release files for browse-code 0.2.83

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for browse-code 0.2.83
File Size Uploaded Provenance
browse_code-0.2.83.tar.gz 59.0 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for browse-code 0.2.83
File Interpreter ABI Platform
browse_code-0.2.83-py3-none-any.whl Python 3 none any Details

Total release size: 118.8 kB

Release files / browse_code-0.2.83.tar.gz

Download URL browse_code-0.2.83.tar.gz
Size 59.0 kB
Tags Source
SHA-256 checksum
How to use checksums
eb4fd8780a597ac91019bc7f1e84fd03cdf27c1bc6ad0090bee42b0ceb5609cf
BLAKE2b-256 checksum
How to use checksums
4c509acb0b3033d2aa345f7aa1ceba72c84e47514ddbcd26229d13ddf5eba95d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

Release files / browse_code-0.2.83-py3-none-any.whl

Download URL browse_code-0.2.83-py3-none-any.whl
Size 59.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
377fc73416ab76f1d7ea5cbce7f992e03de68c93adb9465e42f01ddbc51a4944
BLAKE2b-256 checksum
How to use checksums
ea9dd6c72ff5ebbdb05bcd3f2405e9470aa3cb02596098a1ff70e8146fad4da7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

Security for browse-code 0.2.83

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for browse_code-0.2.83.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 4, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.83 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page