Helix Private Coding Fleet

Run parallel coding agents on your infrastructure, from reviewed specs to pull requests.

Source repo
helixml/helix
Stars
★ 829
Last updated
2d ago
License
NOASSERTION
Primary language
Go

At a glance

How it runs
Self-hosted serviceWeb app
Works with
Universal · cross-platformCodex · Claude Code · OpenAI API · Claude API
Cost
Free tier plus a paid hosted plan
Setup effort
High · needs real infrastructure
You'll need
DockerDocker ComposeGo 1.24.0+Node.js 18+MakeShell / CLINetwork accessLocal filesystemMCP Server
Typical use
An engineering team with several independent features or bug fixes that wants to dispatch coding work in parallel while retaining a shared board and PR review.
Not a fit if
  • Companies over $10M revenue or 250 employees need a paid license
  • Individuals without GPU or Kubernetes infrastructure wanting one local agent
  • Teams planning to build a competing product from this code

What does this agent do, and when should you use it?

Helix is a private coding-agent fleet platform organized around projects, connected Git repositories, and Kanban-based spec tasks. A task progresses through Backlog, Planning, Spec Review, In Progress, Pull Request, and Merged: a planning agent writes a specification to a helix-specs branch, then an approved implementation agent changes code and opens a PR. Each active agent runs in an isolated, GPU-accelerated desktop environment with a browser, terminal, filesystem, and GUI applications. Teams can observe work live, steer it through the task thread, and switch agent harnesses during a task. Helix supports Claude Code, OpenAI Codex, Gemini CLI, Qwen Code, Goose, Zed Agent, and ACP-compatible agents, with GitHub, GitLab, and Azure DevOps source-control connections. It offers Docker installation plus Kubernetes Helm charts for the control plane and GPU runners, including an end-to-end self-hosted and air-gapped deployment path.

A user connects one or more Git repositories to a project and creates a spec task on the Kanban board. Selecting Start Planning causes a planning agent to read the repository and write requirements, design, and task breakdown to a helix-specs branch; the user can request changes by highlighting text or approve the specification. In In Progress, an implementation agent runs in its own desktop sandbox using the selected agent harness, with access to a browser, terminal, filesystem, and GUI apps; users can watch live, steer through the task thread, or switch agents mid-session. When the work is complete, Helix opens a Pull Request in the connected source-control system, and the task closes after the PR merges. The platform also ingests PDF, Word, text, and scraped web content for knowledge/RAG, integrates tools through REST/OpenAPI, MCP, GPTScript, and a custom-tool SDK, and traces LLM, API, and MCP requests alongside token usage and cost.

  1. An engineering team with several independent features or bug fixes that wants to dispatch coding work in parallel while retaining a shared board and PR review.
  2. An enterprise running self-hosted models in a controlled or isolated network that needs coding agents and GPU runners on its own infrastructure.
  3. A project lead using GitHub, GitLab, or Azure DevOps who wants to approve an agent-produced specification before implementation and keep the PR as the final review gate.
  4. A development team that needs to choose or switch among Claude Code, OpenAI Codex, Gemini CLI, Qwen Code, or an ACP-compatible agent for individual tasks.
  5. An internal engineering group that wants agents to work with PDF, Word, text, or scraped-web knowledge through the documented RAG capabilities.

How do you install or deploy this agent?

For the Docker quick start:

curl -sL -O https://get.helixml.tech/install.sh
chmod +x install.sh
sudo ./install.sh

The installer prompts before changing the system, and the dashboard defaults to http://localhost:8080. Production deployment is documented through Control Plane and Runner Helm charts. Server configuration uses environment variables: configure OPENAI_API_KEY or ANTHROPIC_API_KEY for the chosen hosted provider, POSTGRES_* for database connectivity, SERVER_URL for the public deployment URL, and RUNNER_* for GPU runner configuration. Local development requires Docker Desktop, or Docker with Docker Compose, plus Go 1.24.0+, Node.js 18+, and Make.

How do you use this agent?

Open http://localhost:8080 after installation, create a project, and connect one or more Git repositories. Create a spec task in Backlog that states the desired outcome, then select Start Planning; the planning agent writes the specification to the helix-specs branch. Review it in Spec Review, highlighting text to request changes or selecting Approve. In In Progress, choose an available agent harness and steer the agent through the task thread; switch agents if needed. The completed agent opens a PR in the connected source-control system, and merging that PR moves the task to Merged.

What are this agent's strengths and limitations?

Pros
  • It makes specification review and pull requests explicit gates: plans are written to a helix-specs branch and implementation returns through the existing code-hosting workflow.
  • Each agent receives an isolated, GPU-accelerated desktop with a browser, terminal, filesystem, and GUI apps rather than only a shared terminal session.
  • Tasks can select or switch among Claude Code, Codex, Gemini CLI, Qwen Code, Goose, Zed Agent, and ACP-compatible agents, while also supporting OpenAI-compatible endpoints.
  • It provides both a Docker quick start and Kubernetes control-plane and runner Helm charts, with documented self-hosted and air-gapped operation.
  • RAG, OpenAPI/MCP tool connectivity, OIDC, RBAC, and usage/cost tracing are included for teams centralizing agent operations.
Limitations
  • Local development explicitly requires Docker, Docker Compose, Go 1.24.0+, Node.js 18+, and Make; production also requires planning for a control plane and GPU runners.
  • Hosted-model usage requires the relevant OPENAI_API_KEY or ANTHROPIC_API_KEY, while self-hosted use requires a reachable OpenAI-compatible endpoint and customer-managed GPU capacity.
  • The spec, approval, and PR workflow suits collaborative delivery but may be heavier than a one-off, local terminal-assistance workflow.
  • Large commercial use is subject to license terms: companies with more than $10M in annual revenue or 250 employees must purchase a license through Launchpad.
  • The README does not specify per-host agent density, GPU sizing, resource-scheduling behavior, or feature differences between supported agent harnesses, so capacity planning needs independent validation.

How does this agent compare with similar options?

Helix runs agents server-side in separate desktop environments and manages them through a shared Kanban board. Its stated contrast is the local-terminal pattern of running one Claude Code, Codex, or Gemini agent on a developer’s laptop; Helix uses those harnesses as selectable task executors rather than replacing them.

Key facts side by side with the most closely related agents.

Agent Source review Form / cost Stars Updated Language Full support on
Helix Private Coding Fleet This agent 51 · Major gaps Self-hosted serviceFreemium ★ 829 2d ago Go Codex · Claude Code · OpenAI API · Claude API
Symphony Insufficient evidence CLIFree + model costs ★ 28k 1mo ago Elixir Codex
OSpec 69 · Some gaps CLIFree + model costs ★ 390 2mo ago JavaScript Codex · Claude Code
fx Coding Agent 65 · Some gaps CLIFree + model costs ★ 3.8k today Zig ChatGPT · Codex · OpenAI API

How does FollowAgents rate this agent?

FollowAgents source review · FARS-2.1
Major gaps
51/ 100 5-point scale 2.6 / 5
Trust 11/29
Reliability 6/14
Adaptability 14/18
Convention 9/18
Effectiveness 7/13
Verifiability 4/8
Why each dimension lost points
Trust11 / 29 · 1.9/5

The README describes private infrastructure, isolated sandboxes, credential and network isolation, and user approval of plans; the installer is said to prompt before changing the system. The sample does not show implementation details for those safeguards. The CLI skill requires an API key and exposes session and bot operations, while the Drone MCP uses a bearer token and writes logs under a temporary directory; finer-grained credential protection, log cleanup, and authorization controls are not evidenced. Contributor instructions exist, but publisher identity and a verifiable user-facing update path are not established.

Reliability6 / 14 · 2.1/5

The sampled workflow has clear task stages, and the scripts include failure checks; the Drone tool returns errors and the sandbox test sample covers synchronization failures. Deductions reflect the limited sample, which cannot establish consistency across the whole product, and the large dependency set has no supplied evidence of availability guarantees, integrity review, or dependency security assessment.

Adaptability14 / 18 · 3.9/5

The README identifies teams running coding agents on their own infrastructure and describes collaborative Kanban tasks, agent switching, source-control integrations, model providers, and GPU runners. It lists harnesses, ACP, deployment modes, and some boundaries. The broad product scope is not accompanied here by detailed component limits or precise trigger conditions, and Docker, local development, and Kubernetes setup still rely on external documentation.

Convention9 / 18 · 2.5/5

The README is organized around product capabilities, quick start, configuration, development, documentation, contribution, and licensing, with Docker and Helm entry points and CLI/MCP examples. Production details and limitations largely point to documentation not included in the packet. Licensing is complex: README terms for free use and the subscription-service agreement in LICENSE.md require reconciliation by readers. The sample does not provide a clear release changelog or a verifiable maintenance owner and update commitment.

Effectiveness7 / 13 · 2.7/5

The Kanban flow, per-agent desktops, parallel work, and pull-request review provide a concrete path from task description to code review; the Drone MCP formats build, step, and log information for use. The claimed productivity and cost advantages remain product assertions in this sample. There is no quantification of deployment effort, GPU resources, operations, or savings to support an ordinary user's cost-benefit judgment.

Verifiability4 / 8 · 2.5/5

Some README claims are consistent with the sampled CLI skill, MCP server, Go dependencies, Helm test template, and sandbox scripts, and the documentation distinguishes several capabilities and setup steps. Most product claims lack independent corroboration in the sample, and promotional benefits are not systematically separated from verifiable facts. This is a static review only; no execution or independent validation is claimed.

Risks and how to mitigate them
  • Deployment involves GPU runners, repositories, model-provider credentials, and external integrations; verify actual permission boundaries, data flows, log retention, and backup recovery before production use.
  • The README's free-use description and the subscription agreement in the license file are not straightforward to reconcile; review the complete terms that apply to the intended deployment.
  • Include GPU, storage, cluster, and operational costs in evaluation; the sample provides no verifiable cost or performance measurements.
Evidence confidence: Low Reviewed Nov 08, 2026 Reviewed revision 0a1c0e10a787
See the full review method →
Maintain this project? Add the FARS badge to your README

The badge shows the current review score and verdict and links back to this page. It refreshes about once an hour after a re-review.

FARS

[![FARS review](https://followagents.com/badge/helixml-helix.svg)](https://followagents.com/en/agents/helixml-helix)
<a href="https://followagents.com/en/agents/helixml-helix"><img src="https://followagents.com/badge/helixml-helix.svg" alt="FARS review"></a>

Recent releases

Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.

  1. 2.12.51
    Release notes excerpt
    What's Changed * fix(frontend): clear first embed message draft by @chocobar in https://github.com/helixml/helix/pull/3521 * Recover org bots after transient provider outages by @chocobar in https://github.com/helixml/helix/pull/3522 Full Changelog: https://github.com/helixml/helix/compare/2.12.50...2.12.51
    View on GitHub ↗
  2. 2.12.50
    Release notes excerpt
    What's Changed * fix(api): stop reflecting upstream errors on git connection validation (TST-01-271) by @chocobar in https://github.com/helixml/helix/pull/3518 * fix(api): restrict /debug/pprof to admins (TST-01-050) by @chocobar in https://github.com/helixml/helix/pull/3517 * fix(api): block SSRF via git browse-remote base_url (TST-01-272) by @chocobar in https://github.com/helixml/helix/pull/3516 * fix(api): block SSRF via provider endpoint base_url (TST-01-270) by @chocobar in https://github.com/helixml/helix/pull/3514 …
    View on GitHub ↗
  3. 2.12.49
    Release notes excerpt
    What's Changed * chore(zed): bump Zed to stop per-event websocket log lines by @nessie993 in https://github.com/helixml/helix/pull/3503 * chore(deploy): rotate container logs by @nessie993 in https://github.com/helixml/helix/pull/3501 * fix(settings-sync): log a persistent poll error once, not every 30s by @nessie993 in https://github.com/helixml/helix/pull/3502 * fix(hydra): stop tracked-but-stopped desktops pinning GC; harden orphan reaper by @nessie993 in https://github.com/helixml/helix/pull/3504 …
    View on GitHub ↗

FAQ

Is Helix tied to one model provider?
No. It supports major hosted providers and any OpenAI-compatible endpoint as an external provider. The documented paths also include an Anthropic proxy, Anthropic on Google Vertex AI or AWS Bedrock, and self-hosted vLLM.
Do agents run on each developer’s machine?
The intended model is server-side execution. Each agent gets its own isolated desktop sandbox, while team members observe, steer, and continue work from the shared interface.
How does code reach the main branch?
Planning writes to a helix-specs branch. After implementation, Helix opens a PR in the connected repository; the PR is the real review gate, and the task closes after it merges.
Can it operate without internet access?
Helix describes an end-to-end self-hosted, air-gapped path using self-hosted models and owned GPUs. The practical deployment still depends on the selected installation, image, model, and source-control connectivity arrangements.
What are the commercial-use limits?
The repository source may be run free for personal and educational use and for companies below $10M annual revenue and 250 employees. Larger commercial use requires a Launchpad license, and the code may not be used to build a competing product.
Was this page helpful?
View on GitHub ↗ Install ↓

Compare agents like this one

The same FARS review applied across the shortlist this agent qualifies for.