@devlln/helm

Helm

Helm sets up the bridge and CLI helpers that keep local Codex sessions reachable from other devices. It handles runtime detection, shell integration, bridge startup, and pairing from one command.

Install

npm

npm install -g @devlln/helm
helm setup

Homebrew

brew tap devlln/helm
brew install devlln/helm/helm
helm setup

GitHub install

npm install -g github:DEVLlN/helm
helm setup

Setup

Run the guided setup:

helm setup

helm setup installs the CLI, bridge helpers, runtime shims, shell integration, and binary capture. It also checks local runtimes, can guide Tailscale sign-in, starts the bridge, and prints a pairing QR in the terminal.

Useful setup commands:

helm setup --skip-tailscale
helm setup --no-pairing-qr
helm platforms
helm platforms --json

Helm can detect:

• Codex CLI
• Codex.app with its embedded CLI
• Claude
• Grok
• Ollama for local Gemma and Qwen models
• Tailscale for remote pairing

Usage

Bridge lifecycle:

helm bridge up
helm bridge pair
helm bridge status
helm bridge down

Runtime helpers:

helm-codex
helm-claude
helm-grok
helm-gemma
helm-qwen

Lower-level helpers:

helm-prototype-up
helm-prototype-status
helm-prototype-down
helm-pairing-qr

Compatibility aliases:

helm up
helm pair
helm status
helm down

If Tailscale is connected, Helm prefers the Tailscale bridge URL automatically when it prints pairing details.

Feature Status

Completed in the public release

• One-command setup with helm setup
• Codex CLI and Codex.app detection
• Claude and Grok runtime wrapping
• Ollama-based helm-gemma and helm-qwen helpers
• Tailscale-aware pairing and terminal QR output
• Bridge lifecycle commands for up, pair, status, and down
• Shell integration and binary capture for GUI-launched tools
• Public npm install via npm install -g @devlln/helm
• Homebrew install via devlln/helm
• GitHub install via npm install -g github:DEVLlN/helm

In progress

• More first-run validation and repair guidance
• Broader runtime detection hardening across different local setups

Planned

• More runtime and provider wrappers
• Better pairing diagnostics and recovery commands
• Additional client integrations built on the bridge API

Maintainers

Quick validation before tagging a release:

scripts/check-public-repo.sh
scripts/test-install-sandbox.sh --smoke --cleanup --no-runtime-start
npm run pack:dry-run

Release details live in docs/DISTRIBUTION.md. Test notes live in TESTING.md.