helm-agent
v0.0.25
Published
Helm agent daemon + CLI
Readme
helm-agent
Headless agent daemon + helm CLI, wrapping @anthropic-ai/claude-agent-sdk.
The desktop UI in helm-desktop talks to
this daemon over HTTP+SSE; the CLI also works standalone.
Install
npm i -g helm-agent
helm --versionRequires Node 20+.
Linux terminal prerequisites (optional)
The terminal tab is backed by node-pty,
which ships prebuilt binaries for macOS and Windows but not Linux — on Linux
it compiles from source at install time. Every other Helm feature works without
it; only the terminal tab needs it. If you want the terminal on Linux:
- Install the build toolchain — Debian/Ubuntu:
apt install make python3 build-essential; Fedora/RHEL:dnf install make python3 gcc-c++; Alpine:apk add make python3 build-base. - Allow
node-ptyto run its build script for your package manager:- npm / yarn-classic — run install scripts by default; nothing extra.
- pnpm 10+ — blocks build scripts by default:
pnpm add -g --allow-build=node-pty helm-agent(global) orpnpm approve-builds(project). - bun —
bun pm trust node-pty(or addnode-ptytotrustedDependencies).
Run helm doctor afterward — the terminal_runtime check confirms whether the
native module loaded and reprints these steps if not.
Usage
helm daemon start --json # boots the local HTTP daemon, prints handshake
helm daemon status
helm daemon stop
helm session new --help
helm workspace --helpState and logs live under ~/.helm by default (override with HELM_HOME).
Links
- Source: https://github.com/sorrycc/Helm
- Architecture:
docs/designs/2026-04-20-helm-arch.mdin the source repo
