@companyhelm/cli 0.4.0 → 0.4.2

package/dist/cli_io_interface.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Receives user-visible CLI output so command classes can be tested without
+ * coupling business behavior to process globals or a specific terminal stream.
+ */
+export interface CliIo {
+    /** Writes a normal output line to the CLI user. */
+    writeLine(message: string): void;
+    /** Writes an error output line to the CLI user. */
+    writeError(message: string): void;
+}

package/dist/cli_io_interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli_io_interface.js.map

package/dist/cli_io_interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli_io_interface.js","sourceRoot":"","sources":["../src/cli_io_interface.ts"],"names":[],"mappings":""}

package/dist/companyhelm_cli.d.ts

@@ -0,0 +1,20 @@
+import { Command } from "commander";
+import type { CliIo } from "./cli_io_interface.js";
+/**
+ * Defines the public `companyhelm` command that npm users install. The initial
+ * command surface intentionally focuses on package discovery and local stack
+ * entry points while the server and runner implementations evolve separately.
+ */
+export declare class CompanyHelmCli {
+    private readonly io;
+    constructor(io?: CliIo);
+    run(argv: string[]): Promise<void>;
+    createProgram(): Command;
+    private createStatusCommand;
+    private createServerCommand;
+    private createRunnerCommand;
+    private printStatus;
+    private printServerCommand;
+    private printRunnerCommand;
+    private readVersion;
+}

package/dist/companyhelm_cli.js

@@ -0,0 +1,73 @@
+import { readFileSync } from "node:fs";
+import { Command } from "commander";
+import { ConsoleIo } from "./console_io.js";
+/**
+ * Defines the public `companyhelm` command that npm users install. The initial
+ * command surface intentionally focuses on package discovery and local stack
+ * entry points while the server and runner implementations evolve separately.
+ */
+export class CompanyHelmCli {
+    io;
+    constructor(io = new ConsoleIo()) {
+        this.io = io;
+    }
+    async run(argv) {
+        await this.createProgram().parseAsync(argv, {
+            from: "node",
+        });
+    }
+    createProgram() {
+        const program = new Command()
+            .name("companyhelm")
+            .description("CompanyHelm self-hosting CLI.")
+            .version(this.readVersion())
+            .showHelpAfterError()
+            .configureOutput({
+            writeErr: (message) => this.io.writeError(message.trimEnd()),
+            writeOut: (message) => this.io.writeLine(message.trimEnd()),
+        });
+        program.addCommand(this.createStatusCommand());
+        program.addCommand(this.createServerCommand());
+        program.addCommand(this.createRunnerCommand());
+        return program;
+    }
+    createStatusCommand() {
+        return new Command("status")
+            .description("Show the installed CompanyHelm CLI package layout.")
+            .action(() => this.printStatus());
+    }
+    createServerCommand() {
+        return new Command("server")
+            .description("Show how to work with the CompanyHelm server package.")
+            .argument("[command]", "Server command to prepare for.", "start")
+            .action((command) => this.printServerCommand(command));
+    }
+    createRunnerCommand() {
+        return new Command("runner")
+            .description("Show how to work with the CompanyHelm runner package.")
+            .argument("[command]", "Runner command to prepare for.", "start")
+            .action((command) => this.printRunnerCommand(command));
+    }
+    printStatus() {
+        this.io.writeLine("CompanyHelm CLI is installed.");
+        this.io.writeLine("Main CLI package: @companyhelm/cli");
+        this.io.writeLine("Runner package: @companyhelm/runner");
+        this.io.writeLine("Server workspace package: @companyhelm/server");
+    }
+    printServerCommand(command) {
+        this.io.writeLine(`Server command requested: ${command}`);
+        this.io.writeLine("Use npm workspace scripts in this repo with -w @companyhelm/server while the packaged server runtime is being finalized.");
+    }
+    printRunnerCommand(command) {
+        this.io.writeLine(`Runner command requested: ${command}`);
+        this.io.writeLine("Use `npm run dev:runner -- start` in this repo, or install the published `@companyhelm/runner` package and run `companyhelm-runner start`.");
+    }
+    readVersion() {
+        const packageDocument = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+        if (typeof packageDocument.version !== "string" || packageDocument.version.length === 0) {
+            return "0.0.0";
+        }
+        return packageDocument.version;
+    }
+}
+//# sourceMappingURL=companyhelm_cli.js.map

package/dist/companyhelm_cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"companyhelm_cli.js","sourceRoot":"","sources":["../src/companyhelm_cli.ts"],"names":[],"mappings":"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"}

package/dist/console_io.d.ts

@@ -0,0 +1,9 @@
+import type { CliIo } from "./cli_io_interface.js";
+/**
+ * Bridges the CLI output interface to the process streams used by npm-created
+ * binaries while keeping command handlers independent from global console APIs.
+ */
+export declare class ConsoleIo implements CliIo {
+    writeLine(message: string): void;
+    writeError(message: string): void;
+}

package/dist/console_io.js

@@ -0,0 +1,13 @@
+/**
+ * Bridges the CLI output interface to the process streams used by npm-created
+ * binaries while keeping command handlers independent from global console APIs.
+ */
+export class ConsoleIo {
+    writeLine(message) {
+        process.stdout.write(`${message}\n`);
+    }
+    writeError(message) {
+        process.stderr.write(`${message}\n`);
+    }
+}
+//# sourceMappingURL=console_io.js.map

package/dist/console_io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console_io.js","sourceRoot":"","sources":["../src/console_io.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,SAAS;IACpB,SAAS,CAAC,OAAe;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,UAAU,CAAC,OAAe;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { CompanyHelmCli } from "./companyhelm_cli.js";
+await new CompanyHelmCli().run(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,IAAI,cAAc,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/package.json

@@ -1,44 +1,36 @@
 {
   "name": "@companyhelm/cli",
-  "version": "0.4.0",
-  "description": "Bootstrap and manage a local CompanyHelm deployment.",
-  "license": "MIT",
-  "private": false,
-  "type": "module",
+  "version": "0.4.2",
+  "description": "CompanyHelm self-hosting command-line interface.",
   "repository": {
     "type": "git",
-    "url": "https://github.com/CompanyHelm/companyhelm"
-  },
-  "engines": {
-    "node": ">=24"
+    "url": "git+https://github.com/CompanyHelm/companyhelm.git",
+    "directory": "packages/cli"
   },
+  "type": "module",
   "bin": {
-    "companyhelm": "dist/cli.js"
+    "companyhelm": "dist/index.js"
   },
   "files": [
-    "dist",
-    "src/templates"
+    "dist"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json && node scripts/copy-templates.cjs",
-    "set-image-version": "npm run build && node dist/cli.js set-image-version",
-    "start": "npm run build && node dist/cli.js",
-    "test": "npm run build && vitest run"
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "lint": "eslint src tests",
+    "prepack": "npm run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "check": "npm run lint && npm run typecheck",
+    "test": "npm run check && node --import tsx --test tests/*.test.ts"
   },
   "dependencies": {
-    "@clack/prompts": "^1.1.0",
-    "@companyhelm/runner": "^0.2.0",
-    "chalk": "^5.6.2",
-    "commander": "^14.0.1",
-    "dockerode": "^4.0.9",
-    "figlet": "^1.9.4",
-    "yaml": "^2.8.1"
+    "commander": "^14.0.3"
   },
   "devDependencies": {
-    "@types/dockerode": "^3.3.44",
-    "@types/figlet": "^1.7.0",
-    "@types/node": "^24.5.2",
-    "typescript": "^5.9.2",
-    "vitest": "^4.0.0"
+    "@types/node": "^20.19.41",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=20.20.0"
   }
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 CompanyHelm
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,66 +0,0 @@
-# CompanyHelm - Distributed AI Agent Orchestration
-
-<a href="https://discord.gg/YueY3dQM9Q"><img src="https://img.shields.io/discord/1456350064065904867?label=Discord&logo=discord&logoColor=white&color=5865F2&style=for-the-badge" alt="Discord"></a>
-
-CompanyHelm is an open-source control plane for running AI-agent companies in your own infrastructure.
-It gives teams a way to organize agents by role, keep humans in the loop for approvals and clarification, and run agent workloads in isolated environments instead of opaque hosted black boxes. Each agent can run its own app infrastructure for testing and create PRs autonomously. Spin up container-isolated agent threads with a click.
-
-[Website](https://www.companyhelm.com/) · [Discord](https://discord.gg/YueY3dQM9Q)
-
-<img width="1843" height="973" alt="Task management" src="https://github.com/user-attachments/assets/c0faa139-06ed-4299-a76f-63c186204038" />
-
-
-## Quick start
-
-Dependecies:
-- Docker
-- Node.js `>=24`
-- Codex subscription or api key
-- Github account
-
-```bash
-npx @companyhelm/cli up
-```
-
-After startup, the CLI prints:
-
-- the local dashboard UI URL
-- the generated username and password
-
-## What CompanyHelm is
-
-From the product perspective, CompanyHelm is built around a few core ideas:
-
-- Your infrastructure, not a vendor-controlled runtime
-- Model-agnostic agent execution through open runners and protocols
-- Easy agent customization: add skills, MCP servers, and custom instructions to agents from the UI
-- Human-in-the-loop workflows: tasks can be steered at any moment through the built-in chat; approvals and questions are still a work in progress
-- Isolated execution so agents can work in parallel with minimal interference. Each runner can spin up the full app infrastructure within Docker and test in isolation
-- YOLO mode by default: agents run commands without pausing for trivial confirmations
-- Remote repository as the source of truth: agents clone the repo and submit PRs automatically
-- Parallel task execution: multiple agents can execute tasks independently in isolated environments
-
-## What the CLI boots locally
-
-`npx @companyhelm/cli up` brings up a local CompanyHelm stack with:
-
-- CompanyHelm API
-- Postgres
-- CompanyHelm frontend
-- CompanyHelm agent runner
-
-
-## Command reference
-
-For the full CLI help:
-
-```bash
-npx @companyhelm/cli --help
-```
-
-Common commands:
-
-```bash
-npx @companyhelm/cli logs {service]
-npx @companyhelm/cli reset
-```

package/dist/cli.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export declare function main(argv?: string[]): Promise<void>;

package/dist/cli.js

@@ -1,39 +0,0 @@
-#!/usr/bin/env node
-import { realpathSync } from "node:fs";
-import { pathToFileURL } from "node:url";
-import { buildProgram } from "./commands/register-commands.js";
-import { InteractiveCommandCancelledError } from "./commands/interactive.js";
-import { CliPackageMetadata } from "./core/runtime/CliPackageMetadata.js";
-function shouldPrintVersion(argv = process.argv) {
-    const args = argv.slice(2);
-    return args.length === 1 && (args[0] === "--version" || args[0] === "-V");
-}
-export async function main(argv = process.argv) {
-    if (shouldPrintVersion(argv)) {
-        process.stdout.write(`${new CliPackageMetadata().version()}\n`);
-        return;
-    }
-    const program = buildProgram();
-    try {
-        await program.parseAsync(argv);
-    }
-    catch (error) {
-        if (error instanceof InteractiveCommandCancelledError) {
-            process.exitCode = 1;
-            return;
-        }
-        const message = error instanceof Error ? error.message : String(error);
-        process.stderr.write(`${message}\n`);
-        process.exitCode = 1;
-    }
-}
-function isCliEntrypoint(argv = process.argv) {
-    const entrypointPath = argv[1];
-    if (!entrypointPath) {
-        return false;
-    }
-    return pathToFileURL(realpathSync(entrypointPath)).href === import.meta.url;
-}
-if (isCliEntrypoint()) {
-    void main();
-}

package/dist/commands/dependencies.d.ts

@@ -1,28 +0,0 @@
-import { type RuntimeVersions } from "../core/runtime/VersionCatalog.js";
-import { type StatusSnapshot } from "../core/status/StatusService.js";
-export type LogLevel = "debug" | "info" | "warn" | "error";
-export type LocalRepoOptionValue = string | true | undefined;
-export interface UpOptions {
-    logLevel?: LogLevel;
-    useHostDockerRuntime?: boolean;
-    apiRepoPath?: LocalRepoOptionValue;
-    webRepoPath?: LocalRepoOptionValue;
-}
-export interface ResetOptions {
-    removeGithubAppConfig?: boolean;
-}
-export interface StatusReport {
-    services: StatusSnapshot;
-    apiUrl?: string;
-    uiUrl?: string;
-    username?: string;
-    versions?: RuntimeVersions;
-}
-export interface CommandDependencies {
-    up(options?: UpOptions): Promise<void>;
-    down(): Promise<void>;
-    status(): Promise<StatusReport>;
-    logs(service: string): Promise<void>;
-    reset(options?: ResetOptions): Promise<void>;
-}
-export declare function createDefaultDependencies(): CommandDependencies;