Back to search
neoswitch
MarketplaceWorks with Claude CodeGitHubIncomplete
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
Markdown
[](/listings/yldm-ai--neo-switch)HTML
<a href="/listings/yldm-ai--neo-switch"><img src="/api/listings/yldm-ai--neo-switch/badge.svg" alt="findsafeskills safety rating" /></a>Install
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 · 30 lines
- {
- "name": "neoswitch",
- "owner": { "name": "yldm-ai" },
- "plugins": [
- {
- "name": "neoswitch",
- "source": {
- "source": "github",
- "repo": "yldm-ai/neo-switch",
- "ref": "v0.4.2"
- },
- "description": "Keep Claude Code, switch the model: use Gemini 4 Neon in Claude Code through a local Anthropic-compatible proxy, with Antigravity OAuth, the Gemini API or Vertex AI.",
- "keywords": [
- "claude-code",
- "claude",
- "gemini",
- "gemini-4-neon",
- "antigravity",
- "oauth",
- "anthropic-compatible",
- "proxy",
- "vertex-ai",
- "ai-coding",
- "model-routing"
- ],
- "repository": "https://github.com/yldm-ai/neo-switch",
- "license": "MIT"
- }
- ]
- }
README.md · README · 113 lines · 1 finding marked
- # NeoSwitch
- **English** | [简体中文](i18n/README.zh-CN.md) | [繁體中文](i18n/README.zh-TW.md) | [日本語](i18n/README.ja.md) | [한국어](i18n/README.ko.md) | [Español](i18n/README.es.md) | [Français](i18n/README.fr.md) | [Deutsch](i18n/README.de.md) | [Português (Brasil)](i18n/README.pt-BR.md) | [Русский](i18n/README.ru.md)
- [](https://github.com/yldm-ai/neo-switch/blob/main/.claude-plugin/plugin.json) [](https://github.com/yldm-ai/neo-switch/blob/main/LICENSE)
- NeoSwitch makes Claude Code answer with Google's Gemini 4 Neon model instead of Claude, while everything else in Claude Code stays the same.
- [](docs/media/neoswitch-demo.mp4)
- You switch one project at a time; your other projects keep using Claude. The plugin works on macOS and Linux. Windows is not supported yet.
- ## Get started
- **1. Install the plugin.** In Claude Code, run these two lines one at a time. Copy each line whole: the first one says `neo-switch`, the second one `neoswitch`.
- ```text
- /plugin marketplace add yldm-ai/neo-switch
- ```
- ```text
- /plugin install neoswitch@neoswitch
- ```
- Then turn on automatic updates, so fixes reach you when Google or Claude Code change something NeoSwitch depends on: run `/plugin`, open the **Marketplaces** tab, choose `neoswitch` and turn on auto-update. Claude Code leaves it off for marketplaces that do not come from Anthropic.
- **2. Sign in with your Google account.** Open Claude Code in the project you want to switch and run:
- ```text
- /neoswitch:login
- ```
- It shows Google's terms warning, opens Google sign-in in your browser through Google's [Antigravity command-line tool (`agy`)](https://antigravity.google/download), and then switches the project on. If `agy` is not on this computer yet, the command first installs it into `~/.local/bin` with Google's official installer (about 230 MB; the installer also adds that folder to your shell's PATH). If you are comfortable with a terminal, a Gemini API key also works: see [docs/cli.md](docs/cli.md#gemini-api-key).
- The command also shows a link, for when the browser it opens is not one you can use, such as on a computer you reach over SSH: open the link in a browser on any device and sign in. With Claude Code 2.1.326 or later, the link appears at once and a dialog asks for the code the page shows: paste it there. On an older Claude Code, and in WSL or the desktop app over SSH, Claude's reply shows the link instead: run `/neoswitch:login` followed by the code. Run `/neoswitch:login` again while signed in to switch to another Google account: it keeps the current one until you finish, and `/neoswitch:login cancel` keeps it for good.
- > [!WARNING]
- > The [Google Antigravity Terms of Service](https://antigravity.google/terms) (section 6) forbid using Antigravity through other tools, and NeoSwitch is such a tool. Google may suspend or close the Antigravity accounts of people who do. `/neoswitch:login` repeats this warning every time. Do not sign in unless you accept that risk.
- **3. Send your next message.** The window where you ran the command uses Gemini 4 Neon from its next message. Other windows and new sessions keep using Claude, with your own Claude login and connectors: run `/neoswitch:on` in each session that should answer with Gemini 4 Neon. If the command's reply asks you to restart instead, because Claude Code was started through a gateway, start `claude` again without it in the same project.
- ## What you will see
- - Once NeoSwitch is set up, a new session that does not use it opens, at most once a day per project, with the note `NeoSwitch is set up: /neoswitch:on answers this session with Gemini 4 Neon, and /neoswitch:off returns it to Claude any time.` It stays away from projects where you ran `/neoswitch:off`; `NEOSWITCH_NO_HINT=1` in your environment turns it off.
- - The header still shows a Claude model name, such as `claude-opus-5-5`. It is only a label: Gemini 4 Neon answers. Choosing another model with `/model` does not change that.
- - A reply can take 5 to 40 seconds before its first words appear. That is normal. If you signed in with `/neoswitch:login`, `/effort low` makes replies start sooner.
- - The first NeoSwitch command after an install or update can take up to a minute while NeoSwitch gets ready.
- - `/neoswitch:status` tells you at any time whether this session uses Claude or Gemini 4 Neon, and what to do next.
- - When a newer NeoSwitch is available, the session note says so and gives the update commands. With auto-update on, Claude Code installs it by itself, and it applies once every Claude Code window has been closed and opened again.
- ## If something goes wrong
- | What you see | What to do |
- |---|---|
- | The session note says NeoSwitch is not set up yet | Run `/neoswitch:login`. Your next message uses Gemini 4 Neon. |
- | A message says `agy` is not installed | `/neoswitch:login` could not install it by itself. Run `curl -fsSL https://antigravity.google/cli/install.sh \| bash` in a terminal, or install it from [Google's download page](https://antigravity.google/download), then run `/neoswitch:login` again. |
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 56 on GitHub
- | Every message fails with a connection error, or the session note says this session cannot answer | Run `/neoswitch:off`: this session continues on Claude from its next message, even if the reply to the command itself fails. If messages keep failing, type `/exit` and start `claude` again: a new session uses Claude, and `/neoswitch:status` tells you what to fix. |
- | The note says other Claude Code windows still share the earlier setup | Close every Claude Code window, open Claude Code again, then run `/neoswitch:on`. |
- | A warning says claude.ai connectors are disabled because another auth source is set | NeoSwitch no longer causes it; an earlier version did. Update the plugin (see below). If it stays, another tool sets `ANTHROPIC_AUTH_TOKEN` or `ANTHROPIC_API_KEY` for Claude Code. |
- | The note says another program is using the port NeoSwitch needs | Close that program and start Claude Code again, or run `/neoswitch:off`. |
- | The note says NeoSwitch could not download its program | Check your internet connection and start Claude Code again. |
- | `/neoswitch:login` is an unknown command | Update the plugin (see below), restart Claude Code, then run `/reload-plugins`. |
- | A message says your Google account's Antigravity plan does not offer gemini-4-neon | Your plan does not include Gemini 4 Neon, so NeoSwitch cannot answer with it and leaves the project on Claude. Run `/neoswitch:login` again to sign in with an account whose plan has it, or run `/neoswitch:off` and start a new session to go back to Claude. |
- ## Turn it off, update or remove
- - `/neoswitch:off` switches this session back to Claude from its next message, with your own Claude login. `/neoswitch:on` switches it to Gemini 4 Neon again without setting anything up again. Closing a session ends its switch: every new session starts on Claude.
- To update by hand, run these in a terminal, then close all Claude Code windows and open them again:
- ```bash
- claude plugin marketplace update neoswitch
- claude plugin update neoswitch@neoswitch
- ```
- If you added the marketplace under its old name `yldm-ai/NeoSwitch` / `yldm-ai/neon-switch`, add it again with `claude plugin marketplace add yldm-ai/neo-switch` first.
- To remove NeoSwitch:
- 1. Run `/neoswitch:off` in each project you switched on. A project left on keeps pointing at NeoSwitch and stops answering once NeoSwitch is gone. If you already removed the plugin, open `.claude/settings.local.json` in each such project and delete `ANTHROPIC_BASE_URL`, `ANTHROPIC_CUSTOM_HEADERS`, `NODE_EXTRA_CA_CERTS`, `CLAUDE_CODE_USE_GATEWAY` and, from earlier versions, `ANTHROPIC_AUTH_TOKEN` from its `env` object.
- 2. Close the Claude Code windows that use NeoSwitch, then run these in a terminal:
- ```bash
- claude plugin uninstall neoswitch@neoswitch
- claude plugin marketplace remove neoswitch
- ```
- 3. Delete the files NeoSwitch keeps outside your projects:
- | What | Where |
- |---|---|
- | The NeoSwitch program the plugin downloads or builds | `$XDG_CACHE_HOME/neoswitch/`, or `~/.cache/neoswitch/` when `XDG_CACHE_HOME` is unset |
- | Settings and log: `proxy.json` (address, access key and chosen route) and `daemon.log` | `NEOSWITCH_STATE_DIR` when set; otherwise `~/Library/Application Support/neoswitch/` on macOS and `$XDG_CONFIG_HOME/neoswitch/` or `~/.config/neoswitch/` on Linux |
- The Google sign-in is kept by `agy`, not by NeoSwitch, and stays in place; so does `agy` itself, even when `/neoswitch:login` installed it.
- ## What NeoSwitch changes
- While a session in a project uses Gemini 4 Neon, NeoSwitch adds three entries to the `env` object of that project's `.claude/settings.local.json`, and removes them once no session there uses it:
- - `ANTHROPIC_BASE_URL`, `ANTHROPIC_CUSTOM_HEADERS` and `NODE_EXTRA_CA_CERTS` send the project's Claude Code requests to NeoSwitch on this computer, over an encrypted connection only NeoSwitch can answer. NeoSwitch answers the sessions you switched with Gemini 4 Neon and passes every other request on to Claude unchanged, with your own Claude login, which it neither keeps nor logs. The header holds a key that only opens NeoSwitch on this computer.
- In a Git project, NeoSwitch also adds `.claude/settings.local.json` to the clone's own exclude list (`.git/info/exclude`), so the token stays out of commits; your `.gitignore` is not touched.
- NeoSwitch runs only on this computer and accepts connections only from it. It logs no prompts, replies, keys or sign-in details, and no server of ours is involved. The Google sign-in stays inside `agy`; NeoSwitch never reads it.
- ## More
- What works and what does not, how NeoSwitch works, the standalone command-line tool, environment variables, the roadmap and development: [docs/cli.md](docs/cli.md). Also: [Antigravity sign-in details](docs/antigravity.md) and the [protocol contract](docs/protocol-contract.md).
- See [CONTRIBUTING.md](CONTRIBUTING.md) to contribute, [SECURITY.md](SECURITY.md) to report a vulnerability privately, and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) for the code of conduct.
- MIT License
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.