helix-pro

helix-pro is a one-command installer for the native Helix local MCP integration defined in helix_mcp/README.md.

The npm package contains only the helix_mcp adapter and its OpenCode assets: the MCP server, the helix agent, Helix skills, and slash-command templates. It does not include triton-agent/src, the Helix CLI, or the wider triton-agent skills tree.

Prerequisites

• Node.js 20+ and npm.
• OpenCode.
• uv on PATH.
• An existing triton-agent checkout containing pyproject.toml and src/helix.
• The checkout dependencies synchronized:

cd /path/to/triton-agent
uv sync

The supplied checkout remains the Helix CLI runtime. Its Python dependencies, fastmcp, torch, torch_npu, and Ascend runtime requirements are not installed by this npm package.

Install

npx --yes helix-pro install --triton-agent /path/to/triton-agent

The installer deploys bundled helix_mcp assets to the current user's OpenCode configuration directory (default: ~/.config/opencode):

• helix_mcp/: the packaged MCP server and its local assets;
• skills/helix-orchestrator and skills/helix-env-probe;
• agents/helix.md;
• commands: helix-agent, helix-devMode, helix-workspace, helix-single-operator, and helix-batch-operator;
• a native mcp.helix entry and matching permissions in opencode.json.

The registered MCP starts the packaged server with the user-supplied triton-agent as its uv project and runtime source:

{
  "mcp": {
    "helix": {
      "type": "local",
      "command": [
        "uv",
        "--project",
        "/path/to/triton-agent",
        "run",
        "python",
        "/home/user/.config/opencode/helix_mcp/helix_mcp_server.py"
      ],
      "cwd": "/path/to/triton-agent",
      "environment": {
        "HELIX_TRITON_AGENT_DIR": "/path/to/triton-agent"
      },
      "enabled": true,
      "timeout": 10000
    }
  }
}

The installer preserves unrelated settings and JSONC comments in an existing opencode.json. Re-running it replaces only the Helix MCP entry and Helix-owned OpenCode assets.

For an isolated OpenCode configuration directory, set OPENCODE_CONFIG_DIR:

OPENCODE_CONFIG_DIR=/tmp/opencode-config \
  npx --yes helix-pro install --triton-agent /path/to/triton-agent

Use

Start OpenCode in an operator workspace, then switch to the helix primary agent:

cd /path/to/operator-workspace
opencode

The agent, skills, persistent MCP configuration, workspace behavior, and exposed tool contract follow the packaged helix_mcp README.

Development

After modifying ../helix_mcp, refresh the packaged MCP asset snapshot before packing:

npm run sync:mcp-assets

Then run:

npm install
npm test
npm run pack:check
npm pack