CompanyHelm Runner

Run the CompanyHelm runner in isolated Docker sandboxes on your machine.

Install

npm install -g @companyhelm/runner

Or run it without installing globally:

npx @companyhelm/runner --help

Package: @companyhelm/runner

Basic Usage

Start the CLI in the foreground:

companyhelm-runner

Start it as a daemon:

companyhelm-runner --daemon

Check whether the daemon is running:

companyhelm-runner status

Open the interactive state DB shell:

companyhelm-runner shell

From the shell you can inspect threads and daemon state, and open a Docker bash session inside a selected thread runtime container.

The status command prints:

• whether the daemon is running
• the recorded daemon PID
• the daemon log directory and log file path

Why Use It

• Runs agents in isolated containers instead of directly on your machine
• Supports Docker-in-Docker for end-to-end workflows
• Keeps runner state in a local SQLite database
• Supports long-running daemon mode for background operation

For Developers

Development and maintenance notes live in DEVELOPING.md.

License

MIT