Skip to content
Back to search

HarnessXGate

Zero-dependency multi-engine free AI router with auto-failover, live web dashboard, MCP server & one-command installer.

Safety scan

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

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/eli-mira--harnessxgate/badge.svg)](/listings/eli-mira--harnessxgate)

HTML

<a href="/listings/eli-mira--harnessxgate"><img src="/api/listings/eli-mira--harnessxgate/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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.

README.md · README · 89 lines · 3 findings marked
  1. # HarnessXGate
  2. **Free AI multi-engine router, live web dashboard, and MCP server — zero dependencies, one command to install.**
  3. Built so anyone (even without an expensive AI subscription) can combine free AI engines (**OpenCode**, **GitHub Copilot CLI**, **FreeLLMAPI / OpenAI-compatible APIs**, and **Ollama**) behind one simple web page, one CLI (`hxg`), and one MCP tool. When one model hits a rate limit or goes offline, HarnessXGate automatically switches to the next best free model without stopping your work.
  4. ---
  5. ## One-Command Install (Opens the Web App Automatically)
  6. ### Windows — Command Prompt (`cmd`)
  7. ```cmd
  8. curl -fsSL https://raw.githubusercontent.com/Eli-Mira/HarnessXGate/main/install.cmd -o "%TEMP%\hxg.cmd" && "%TEMP%\hxg.cmd"
  9. ```
  10. ### Windows — PowerShell
  11. ```powershell
  12. irm https://raw.githubusercontent.com/Eli-Mira/HarnessXGate/main/install.ps1 | iex
  13. ```
  14. ### macOS / Linux / WSL
  15. ```bash
  16. curl -fsSL https://raw.githubusercontent.com/Eli-Mira/HarnessXGate/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 23 on GitHub
  17. ```
  18. ### Or via `pip`
  19. ```bash
  20. pip install git+https://github.com/Eli-Mira/HarnessXGate.git
  21. hxg
  22. ```
  23. > **Requirements:** Only **Python 3.10+** (zero extra `pip` packages needed!).
  24. ---
  25. ## How to Use (For Beginners — 30 Seconds)
  26. 1. **Open the Dashboard:** Type `hxg` in your terminal (opens `http://127.0.0.1:7878` in your browser).
  27. 2. **Check Your Engines:** You only need **one** green (`Ready`) engine to start:
  28. - **OpenCode (Free):** `curl -fsSL https://opencode.ai/install | bash`
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 40 on GitHub
  29. - **Ollama (100% Offline & Free):** Install from [ollama.com](https://ollama.com) and run `ollama pull qwen2.5-coder`
  30. - **GitHub Copilot CLI:** `copilot login`
  31. - **FreeLLMAPI / OpenRouter / Groq:** Run `hxg setup` and paste your URL + API key.
  32. 3. **Ask Anything:** Type your question in the **Quick Ask** box on the web dashboard (or run `hxg ask "Explain recursion simply"` in your terminal).
  33. ---
  34. ## CLI Commands
  35. | Command | What it does |
  36. |---|---|
  37. | `hxg` (or `hxg ui`) | Starts the live web dashboard at `http://127.0.0.1:7878` |
  38. | `hxg ask "your prompt"` | Runs a prompt with automatic model & engine failover (`--task quick\|code\|deep\|review`) |
  39. | `hxg health` | Shows which AI engines are ready right now |
  40. | `hxg status` | Shows active running workers, engine counts, and recent events |
  41. | `hxg watch` | Opens a live auto-refreshing terminal monitor |
  42. | `hxg setup` | 30-second guided setup wizard for API URLs & keys |
  43. | `hxg mcp` | Runs the stdio MCP server (`fleet_health`, `fleet_status`, `fleet_ask`, `fleet_sessions`) |
  44. ---
  45. ## Connect to AI Coding Tools (MCP)
  46. ### Antigravity (`agy`)
  47. ```bash
  48. agy mcp add harnessxgate hxg mcp
  49. ```
  50. ### Claude Desktop / Cursor / Hermes
  51. Add to your MCP config:
  52. ```json
  53. {
  54. "mcpServers": {
  55. "harnessxgate": {
  56. "command": "hxg",
  57. "args": ["mcp"]
  58. }
  59. }
  60. }
  61. ```
  62. ---
  63. ## Privacy & Safety
  64. - Runs **100% locally on `127.0.0.1`** — zero cloud telemetry, zero tracking.
  65. - API keys are read from environment variables or `~/.harnessxgate/.env` in memory only and never logged.
  66. ## License
  67. MIT — built by **EliLain**.

Ratings and comments

Sign in to rate this skill.

Sign in

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