{"id":47935141,"url":"https://github.com/dpavlin/firefox-aistudio-plugin","last_synced_at":"2026-04-04T07:40:19.062Z","repository":{"id":290716536,"uuid":"974712427","full_name":"dpavlin/firefox-aistudio-plugin","owner":"dpavlin","description":"[vibe-coded in a week, 200k tokens, expect churn] Firefox plugin for Google AI Studio integration with local file system","archived":false,"fork":false,"pushed_at":"2025-05-14T05:54:25.000Z","size":459,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-14T06:51:34.889Z","etag":null,"topics":["firefox","gemini","git"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dpavlin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-29T07:36:10.000Z","updated_at":"2025-05-14T05:54:29.000Z","dependencies_parsed_at":"2025-04-30T07:52:39.666Z","dependency_job_id":null,"html_url":"https://github.com/dpavlin/firefox-aistudio-plugin","commit_stats":null,"previous_names":["dpavlin/firefox-aistudio-plugin"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dpavlin/firefox-aistudio-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpavlin%2Ffirefox-aistudio-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpavlin%2Ffirefox-aistudio-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpavlin%2Ffirefox-aistudio-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpavlin%2Ffirefox-aistudio-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dpavlin","download_url":"https://codeload.github.com/dpavlin/firefox-aistudio-plugin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpavlin%2Ffirefox-aistudio-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31392186,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T04:26:24.776Z","status":"ssl_error","status_checked_at":"2026-04-04T04:23:34.147Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["firefox","gemini","git"],"created_at":"2026-04-04T07:40:18.193Z","updated_at":"2026-04-04T07:40:19.050Z","avatar_url":"https://github.com/dpavlin.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AI Code Capture\n\nFirefox plugin for Google AI Studio integration with local file system\n\n## Motivation\n\nGoogle Gemini 2.5 Pro is currently best model for discussing your code, freely available via the Google AI Studio web interface.\n\nHowever, manually copy-pasting changes gets old quickly. This project automates that process.\n\n## Install Local Dependencies\n\n```bash\nsudo apt install python3-flask python3-flask-cors\n```\n\n## Start Local Server\n\n```bash\n# Navigate to your project's root directory first\n# Example: Start on default port 5000\npython3 server.py\n\n# Example: Start on port 5001\npython3 server.py -p 5001\n\n# Example: Enable Python execution (Use with caution!)\npython3 server.py --python\n\n# Example: Enable Shell execution (DANGEROUS!)\npython3 server.py --shell\n\n# Example: Combine options\npython3 server.py -p 5050 --python --shell\n```\n*   `-p \u003cport\u003e` or `--port \u003cport\u003e`: Specifies the listening port (default: 5000).\n*   `--python`: Enables auto-execution of received Python files. **Use with caution!**\n*   `--shell`: Enables auto-execution of received Shell scripts. **DANGEROUS! Use only if you fully trust the AI's output and understand the risks.**\n\n*Note: The server no longer uses `server_config.json`. Port and auto-run settings are controlled only at startup.*\n\n## Load Temporary Add-on in Firefox\n\n1.  Go to `about:debugging` in Firefox.\n2.  Click \"This Firefox\".\n3.  Click \"Load Temporary Add-on...\".\n4.  Select the `manifest.json` file inside the `extension` directory.\n\n## Configure Extension Popup\n\n1.  Click the AI Code Capture icon in the Firefox toolbar.\n2.  Enter the **Port** number corresponding to the running server instance you want *this specific AI Studio tab* to communicate with.\n3.  Use the **Active** toggle to enable/disable the extension globally.\n4.  Click **Test** to verify the connection and view server status (including read-only auto-run status based on server flags).\n\n*Port settings are saved per-tab.*\n\n## Pack and Send Source Code to Model\n\nTo provide context to the AI:\n\n```bash\n# Run from your project's root directory\nzip /tmp/firefox-aistudio-plugin.zip $(git ls-files)\n```\n\n*Upload `/tmp/firefox-aistudio-plugin.zip` to AI Studio.*\n\n## Google AI Studio Prompt Instructions\n\n**Crucial:** Instruct the AI how to format its output. Include this in your prompt (refer to `prompt.txt` for the full recommended prompt):\n\n\u003e ALWAYS add in the very first line marker `@@FILENAME@@ path/to/modified/file.ext`.\n\n## Git Integration\n\n*   If the server runs within a local Git repository, it will automatically `git add` and `git commit` changes for **tracked** files specified via the `@@FILENAME@@` marker.\n*   It **will not** add *new* files to Git automatically; you must `git add` them manually first.\n\n## Multiple Projects in Separate Tabs\n\n*   Use the server's `-p \u003cnumber\u003e` option to run multiple instances on different ports for different projects.\n*   Configure the matching port number in the extension popup for each corresponding AI Studio tab. The extension saves the port setting independently for each tab.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdpavlin%2Ffirefox-aistudio-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdpavlin%2Ffirefox-aistudio-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdpavlin%2Ffirefox-aistudio-plugin/lists"}