{"id":50558166,"url":"https://github.com/jamubc/grok-build-providers","last_synced_at":"2026-06-04T09:02:08.104Z","repository":{"id":361840060,"uuid":"1256070367","full_name":"jamubc/grok-build-providers","owner":"jamubc","description":"Give Grok Build access to third-party models natively, without background services.","archived":false,"fork":false,"pushed_at":"2026-06-03T20:55:25.000Z","size":1783,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-03T22:20:52.343Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"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/jamubc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-01T12:39:15.000Z","updated_at":"2026-06-03T20:49:38.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jamubc/grok-build-providers","commit_stats":null,"previous_names":["jamubc/open-grok-build","jamubc/grok-build-providers"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/jamubc/grok-build-providers","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamubc%2Fgrok-build-providers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamubc%2Fgrok-build-providers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamubc%2Fgrok-build-providers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamubc%2Fgrok-build-providers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jamubc","download_url":"https://codeload.github.com/jamubc/grok-build-providers/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamubc%2Fgrok-build-providers/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33897568,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-04T02:00:06.755Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2026-06-04T09:02:06.848Z","updated_at":"2026-06-04T09:02:08.095Z","avatar_url":"https://github.com/jamubc.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# grok-build-providers\n\n![Status](https://img.shields.io/badge/status-active-green)\n![Platform](https://img.shields.io/badge/platform-macOS-lightgrey?logo=apple)\n![License](https://img.shields.io/github/license/jamubc/grok-build-providers)\n![npm version](https://img.shields.io/npm/v/grok-build-providers?color=339933\u0026logo=npm\u0026logoColor=white)\n\nGive Grok Build access to third-party models natively, without background services.\n\n\u003cimg width=\"781\" height=\"243\" alt=\"Screenshot 2026-06-03 at 4 25 10 PM\" src=\"https://github.com/user-attachments/assets/b861d3b6-f0b0-4287-a18c-439378f7337b\" /\u003e\n\n\nThese connectors spin up light, zero-dependency inline HTTP proxies on-the-fly only when Grok is running.\n\n\u003e **Disclaimer:** `grok-build-providers` is an independent, community-built tool. It is **not affiliated with, endorsed by, or sponsored by x.AI, Grok, or any model provider** (OpenAI/Codex, Google/Gemini/Antigravity, DeepSeek, or Alibaba/Qwen). All product names and trademarks belong to their respective owners and are used only to describe interoperability.\n\n## Prerequisites\n\n- **[Grok Build](https://x.ai/cli)** installed and on your `PATH`. This tool configures Grok's connectors; it does not install Grok Build itself.\n- For the inline connectors, the backing CLI must be installed and signed in: **`agy`** (Antigravity/Gemini) or **`codex`** (Codex). The passthrough connectors (**DeepSeek**, **Qwen**) only need an API key.\n\n## Connectors\n\nAll connectors are distributed in a single, unified npm package `grok-build-providers`.\n\n| Command | Provider | Default Model | Config Snippet | Description |\n| :--- | :--- | :--- | :--- | :--- |\n| **`grok-agy`** | ![Gemini](https://img.shields.io/badge/Gemini-8E75B2?logo=googlegemini\u0026logoColor=white\u0026style=flat-square) | `gemini-3.5-flash` | [toml](providers/agy/templates/grok-config-snippet.toml) | Gemini models via Antigravity CLI OAuth |\n| **`grok-codex`** | ![OpenAI](https://img.shields.io/badge/OpenAI-412991?logo=openai\u0026logoColor=white\u0026style=flat-square) | `gpt-5.5` | [toml](providers/codex/templates/grok-config-snippet.toml) | Codex models via the Codex CLI OAuth |\n| **`grok-deepseek`** | ![DeepSeek](https://img.shields.io/badge/DeepSeek-4D6BFE?logo=deepseek\u0026logoColor=white\u0026style=flat-square) | `deepseek-v4-flash` | [manifest](providers/providers.json) | DeepSeek API direct compatible-mode integration |\n| **`grok-qwen`** | ![Qwen](https://img.shields.io/badge/Qwen-FF6A00?logo=qwen\u0026logoColor=white\u0026style=flat-square) | `qwen2.5-coder-32b-instruct` | [manifest](providers/providers.json) | Alibaba DashScope Qwen2.5-Coder models |\n\n\u003e The full connector list is the single source of truth in [`providers/providers.json`](providers/providers.json). See [CONTRIBUTING.md](CONTRIBUTING.md) to add one.\n\n---\n\n## Interactive Configuration Console \u0026 TUI\n\n`grok-build-providers` provides a zero-dependency interactive control panel to manage all your model connectors.\n\n### Install (recommended)\n\nInstall globally with npm, then launch the console:\n\n```bash\nnpm install -g grok-build-providers\ngrok-build-providers\n```\n\nA global install is the recommended setup: it gives every connector, including the inline ones (`agy`, `codex`), a stable home. (See [Trying it without installing](#trying-it-without-installing) for the `npx` caveat.)\n\n### Headless / non-interactive\n\nInstall connectors directly, without the menu:\n\n```bash\ngrok-build-providers agy        # install the Gemini/Antigravity connector\ngrok-build-providers codex      # install the Codex connector\ngrok-build-providers deepseek   # install the DeepSeek connector\ngrok-build-providers qwen       # install the Qwen Coder connector\ngrok-build-providers all        # install everything\n```\n\n### Running without installing\n\n```bash\nnpx grok-build-providers\n```\n\nUse `npx` for a quick try without a global install. What works and what does not:\n\n- **DeepSeek, Qwen (passthrough):** fully supported via `npx`. Their launchers are self-contained and only need an API key.\n- **Gemini/AGY, Codex (inline):** unreliable via `npx`. Their launchers reference the package directory, so they break once npm clears its temporary `npx` cache. Use a global install for these.\n\n---\n\n## Running a connector\n\nAfter installing, launch Grok on a connector with its `grok-\u003cname\u003e` command. It spins up the inline proxy on demand and shuts it down when you exit:\n\n```bash\ngrok-agy                            # interactive Grok session on Antigravity/Gemini\ngrok-codex -p \"explain this repo\"   # one-shot prompt via Codex\n```\n\nOr set one as the global default in the TUI and press `space` to launch.\n\n\u003e **Custom connectors (`agy`, `codex`) must be started through their `grok-\u003cname\u003e` command** (or the TUI's launch), which starts the local proxy first. Running plain `grok` against them fails with `retrying…` because nothing is listening on the proxy port.\n\nTroubleshooting: set `GROK_PROXY_DEBUG=1` before a `grok-\u003cname\u003e` command to write a trace to `~/.cli-proxy-api/logs/inline-proxy-debug.log`.\n\n---\n\n## Features\n* **Status Monitor**: Checks the installation status of all connectors and reports their active default models.\n* **Active Model Switcher**: Swap between connectors (`agy`, `codex`, `deepseek`, `qwen`) as the active default model in your `~/.grok/config.toml` with a single keypress.\n* **Option Adjuster**: Switch default models inside each connector (e.g. `gpt-5.5` vs `gpt-5.4` on Codex, or `gemini-3.5-flash` vs `gemini-3-pro` on AGY).\n* **Quick Installer / Uninstaller**: Set up or cleanly remove any or all connectors (launcher, credentials file, and `config.toml` block) with execution logs rendered inline.\n* **Launch**: Start a Grok session on the active connector straight from the menu (press `space`).\n\n---\n\n## Getting Started\n\n### Prerequisites\n\nRequires **[Grok Build](https://x.ai/cli)** (`grok`) on your PATH. Configuration lives in `~/.grok/config.toml`.\n\n### Development\n\nClone the repository to contribute or run from source:\n\n```bash\ngit clone https://github.com/jamubc/grok-build-providers.git\ncd grok-build-providers\nnpm install\n```\n\n### Installed commands\n\nA global install (see [Install](#install-recommended)) registers:\n\n| Command | Description |\n| :--- | :--- |\n| `grok-build-providers` | Interactive TUI configuration manager |\n| `grok-agy` | Grok Build with Antigravity (Gemini) proxy |\n| `grok-codex` | Grok Build with Codex proxy |\n| `grok-deepseek` | Grok Build with DeepSeek |\n| `grok-qwen` | Grok Build with Qwen Coder |\n\n---\n\n## Issues \u0026 Contributions\n\nHave a bug or feature request?\n* Please open an issue on the **[GitHub Issue Tracker](https://github.com/jamubc/grok-build-providers/issues)**.\n* Check the **[Releases \u0026 Downloads](https://github.com/jamubc/grok-build-providers/releases)** for stable tags and archives.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamubc%2Fgrok-build-providers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjamubc%2Fgrok-build-providers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamubc%2Fgrok-build-providers/lists"}