Skip to content
Back to search

neon-bridge

MarketplaceWorks with Claude CodeGitHub

Gemini 4 Neon as a second assistant inside Claude Code (unofficial).

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/rahil-maniar--neon-bridge/badge.svg)](/listings/rahil-maniar--neon-bridge)

HTML

<a href="/listings/rahil-maniar--neon-bridge"><img src="/api/listings/rahil-maniar--neon-bridge/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

As a Claude Code plugin (recommended)

In Claude Code:

/plugin marketplace add Rahil-Maniar/neon-bridge
/plugin install neon-bridge@neon-bridge

Then run setup once in a terminal. It opens a browser window for you to sign in to Google. The plugin is installed under `~/.claude/plugins/cache/neon-bridge/neon-bridge/<version>/`. You can also simply ask Claude: *"run the neon-bridge setup"*. It will give you the exact command.

node ~/.claude/plugins/cache/neon-bridge/neon-bridge/<version>/bridge/neon.js setup

Standalone (CLI only)

git clone https://github.com/Rahil-Maniar/neon-bridge
cd neon-bridge
npm install
node bridge/neon.js setup

**Setup** installs `playwright-core` if it's needed (it does not download a browser) and opens Chrome with the dedicated profile. You sign in, check that Gemini loads, and close the window. Setup then verifies that the model is selectable.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 12 lines
  1. {
  2. "name": "neon-bridge",
  3. "description": "Gemini 4 Neon as a second assistant inside Claude Code (unofficial).",
  4. "owner": { "name": "Ousen69" },
  5. "plugins": [
  6. {
  7. "name": "neon-bridge",
  8. "source": "./",
  9. "description": "Use Gemini 4 Neon from Claude Code via your own Gemini subscription."
  10. }
  11. ]
  12. }
README.md · README · 110 lines
  1. # neon-bridge
  2. Use **Gemini 4 Neon** as a second assistant inside [Claude Code](https://code.claude.com), or from any terminal, through **your own Gemini subscription**. It needs no API key and no API billing.
  3. Claude gets a `gemini-neon` skill. It can ask Neon for second opinions, hold multi-turn discussions, send attachments, or let Neon investigate a folder on its own in a read-only **agent mode**.
  4. > **Unofficial.** This project is not affiliated with, endorsed by, or supported by Google or Anthropic. It automates the Gemini **web app** in a browser on your machine, which may conflict with Google's Terms of Service. Google can change or block this at any time, and automated use could put your account at risk. Use it at your own risk, for personal, low-volume use.
  5. ## How it works
  6. ```
  7. Claude Code ──skill──▶ neon.js (CLI) ──HTTP, localhost only──▶ daemon ──CDP──▶ hidden Chrome
  8. └─ dedicated profile, signed in to
  9. your Google account → gemini.google.com
  10. ```
  11. - A small daemon keeps a **headless Chrome** running with a **dedicated profile** that only this tool uses. It doesn't touch your normal browser or its cookies.
  12. - For each request it selects the model in Gemini's picker (Neon by default), types the prompt, waits for the full reply, and converts it back to **markdown**.
  13. - The daemon starts on demand and stops after 45 minutes idle.
  14. ## Features
  15. | | |
  16. |---|---|
  17. | **One-shot questions** | `neon.js ask "..."` |
  18. | **Multi-turn sessions** | `-s NAME` continues the same conversation, so Claude can push back and follow up |
  19. | **Attachments** | `-a file` uploads code, PDFs, images and so on. Prompts over 20k characters are sent as a file automatically |
  20. | **Agent mode** | `--agent DIR`: Neon can `LIST` / `READ` / `GREP` / `FIND` files in that folder, read-only. Secret-like files (`.env`, keys, credentials, `.ssh`, …) are always blocked |
  21. | **Clean history** | Chats are temporary by default. Use `--save` to keep one |
  22. | **Other models** | `--model Hydrogen` (or `Carbon` if your plan includes it) |
  23. | **Parallel** | Separate sessions can run at the same time |
  24. ## Requirements
  25. - A Google account with a **Gemini plan that includes the model you want**. Neon currently needs Google AI Pro or Ultra.
  26. - **Google Chrome** (Microsoft Edge or Chromium also work), on Windows, macOS or Linux
  27. - **Node.js 18+** and npm
  28. - Claude Code, if you want the skill. The CLI also works on its own.
  29. ## Install
  30. ### As a Claude Code plugin (recommended)
  31. In Claude Code:
  32. ```
  33. /plugin marketplace add Rahil-Maniar/neon-bridge
  34. /plugin install neon-bridge@neon-bridge
  35. ```
  36. Then run setup once in a terminal. It opens a browser window for you to sign in to Google. The plugin is installed under `~/.claude/plugins/cache/neon-bridge/neon-bridge/<version>/`. You can also simply ask Claude: *"run the neon-bridge setup"*. It will give you the exact command.
  37. ```
  38. node ~/.claude/plugins/cache/neon-bridge/neon-bridge/<version>/bridge/neon.js setup
  39. ```
  40. ### Standalone (CLI only)
  41. ```
  42. git clone https://github.com/Rahil-Maniar/neon-bridge
  43. cd neon-bridge
  44. npm install
  45. node bridge/neon.js setup
  46. ```
  47. **Setup** installs `playwright-core` if it's needed (it does not download a browser) and opens Chrome with the dedicated profile. You sign in, check that Gemini loads, and close the window. Setup then verifies that the model is selectable.
  48. ## Usage
  49. In Claude Code, just ask:
  50. - *"Ask Neon what it thinks of this migration plan."*
  51. - *"Get a second opinion from Gemini on why this test is flaky."*
  52. - *"Have Neon review the `src/auth` folder for bugs."* (agent mode)
  53. From a terminal:
  54. ```
  55. node bridge/neon.js ask "Explain the tradeoffs of optimistic vs pessimistic locking"
  56. node bridge/neon.js ask -s design "Here's my plan: ..." && node bridge/neon.js ask -s design "What would you cut?"
  57. node bridge/neon.js ask -a report.pdf "Summarize the risks in this report"
  58. node bridge/neon.js ask --agent ./my-repo "Find the most likely cause of the race condition in the job queue"
  59. node bridge/neon.js doctor | sessions | end NAME | status | stop [--force]
  60. ```
  61. Exit codes: `0` ok, `2` not set up or signed out, `3` model not available, `4` timed out or partial answer, `1` other.
  62. ## Configuration
  63. Environment variables, or `config.json` in the bridge home:
  64. | Env var | config.json | Default |
  65. |---|---|---|
  66. | `NEON_BRIDGE_HOME` | — | `~/.neon-bridge` (profile, logs, sessions, temp files) |
  67. | `NEON_BROWSER` | `browserPath` | auto-detected Chrome, then Edge, then Chromium |
  68. | `NEON_MODEL` | `model` | `Neon` |
  69. | `NEON_CDP_PORT` / `NEON_API_PORT` | `cdpPort` / `apiPort` | `9333` / `9334` |
  70. | `NEON_IDLE_MINUTES` | `idleMinutes` | `45` |
  71. ## Privacy and security
  72. - **Your Google session lives in `~/.neon-bridge/profile`.** Treat that folder like a password: never share or commit it. `.gitignore` excludes it if it ends up inside the repo.
  73. - Everything you send goes to Google under your account, **even temporary chats**. By default the skill tells Claude never to send login secrets, and to ask before sending sensitive third-party material. If you're comfortable sharing more, say so in your `CLAUDE.md`, for example: *"Sharing project material with Neon is pre-approved."*
  74. - The daemon and the browser's debugging port listen on **127.0.0.1 only**. Note that any program running as you on the same machine could still talk to them.
  75. - Agent mode is read-only and confined to the folder you pass it.
  76. ## Troubleshooting
  77. - **"Not set up" or "signed out":** run `setup` again.
  78. - **Model not available:** check that your plan includes it (open gemini.google.com and look at the model picker), then run `doctor`.
  79. - **It breaks after a Gemini redesign:** the page selectors are in the `SEL` object in `bridge/server.js`. `node bridge/server.js --show` runs the daemon with a visible window, and `bridge/dev/inspect.js` dumps the page's controls. PRs welcome.
  80. - **Hangs:** run `stop --force` and try again. Logs are in `~/.neon-bridge/daemon.log`.
  81. ## License
  82. MIT, see [LICENSE](LICENSE). "Gemini" is a trademark of Google LLC and "Claude" is a trademark of Anthropic; both are used here only to describe compatibility.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.