@companyhelm/cli 0.0.2 → 0.0.6

package/README.md

@@ -1,95 +1,57 @@
-# CompanyHelm Runner
+# CompanyHelm CLI
 
-Run coding agents in yolo mode inside secure Docker containers, locally.
-
-Features:
-
-- Secure agent containers: no risk of agents going rogue on your main file system
-- Yolo mode: no more permission prompts
-- DinD (Docker-in-Docker): allows agents to spin up your services (backend, frontend, etc.) and test end-to-end
-- Multi-agent support: each agent gets its own environment and can operate autonomously
-
----
-
-## Why CompanyHelm Runner?
-
-Modern coding agents are powerful, but they often run directly on your machine.
-
-CompanyHelm Runner adds:
-
-- Isolation
-- Docker-in-Docker (DIND)
-- Clean workspace lifecycle
-
-Think:
-
-Codex or Claude Code, but inside a sandbox you control.
-
----
+Run coding agents in isolated Docker sandboxes on your machine.
 
 ## Install
 
 ```bash
-npm install -g companyhelm
+npm install -g @companyhelm/cli
 ```
 
-Or run directly:
+Or run it without installing globally:
 
 ```bash
-npx companyhelm
+npx @companyhelm/cli --help
 ```
 
----
+Package: [@companyhelm/cli](https://www.npmjs.com/package/@companyhelm/cli)
 
-## Quick Start
+## Basic Usage
 
-Run companyhelm runner inside your workspace:
+Start the CLI in the foreground:
 
 ```bash
-companyhelm
+companyhelm-runner
 ```
 
-## Database Migrations (Drizzle Kit)
-
-Generate SQL migrations from the schema:
-
-```bash
-npm run db:generate
-```
-
-Apply migrations directly with Drizzle Kit (defaults to `~/.local/share/companyhelm/state.db`):
+Start it as a daemon:
 
 ```bash
-npm run db:migrate
+companyhelm-runner --daemon
 ```
 
-Override the migration target database path when needed:
+Check whether the daemon is running:
 
 ```bash
-DRIZZLE_DB_PATH=/absolute/path/to/state.db npm run db:migrate
+companyhelm-runner status
 ```
 
-## Thread-Level MCP E2E Check
+The `status` command prints:
 
-Use the runtime helper to validate thread-level MCP end-to-end behavior for:
+- whether the daemon is running
+- the recorded daemon PID
+- the daemon log directory and log file path
 
-- a local known-good stdio MCP server (`local_echo`)
-- Context7 stdio MCP (`resolve-library-id`, `query-docs`)
+## Why Use It
 
-Prerequisites:
-
-- CompanyHelm API is running and reachable at `http://127.0.0.1:4000/graphql` (or pass `--api-url`)
-- at least one connected runner for the target company with `codex` SDK and an available model
-
-Run:
-
-```bash
-scripts/runtime/e2e-thread-mcp --company-id <company-id>
-```
+- 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
 
-The script exits non-zero on failed assertions and prints a JSON summary on success, including created MCP/agent/thread IDs.
+## For Developers
 
----
+Development and maintenance notes live in [DEVELOPING.md](./DEVELOPING.md).
 
 ## License
 

package/RUNTIME_IMAGE_VERSION

@@ -1 +1 @@
-0.0.7
+0.0.8

package/dist/cli.js

@@ -21,4 +21,32 @@ program
     .description("Run coding agents in fully isolated Docker sandboxes, locally.")
     .version(getVersion());
 (0, register_commands_js_1.registerCommands)(program);
-program.parse(process.argv);
+function formatCliError(error) {
+    if (error instanceof commander_1.CommanderError) {
+        return {
+            message: error.message,
+            exitCode: error.exitCode,
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            message: error.message,
+            exitCode: 1,
+        };
+    }
+    return {
+        message: String(error),
+        exitCode: 1,
+    };
+}
+async function main() {
+    try {
+        await program.parseAsync(process.argv);
+    }
+    catch (error) {
+        const { message, exitCode } = formatCliError(error);
+        process.stderr.write(`${message}\n`);
+        process.exitCode = exitCode;
+    }
+}
+void main();

package/dist/commands/register-commands.js

@@ -4,9 +4,11 @@ exports.registerCommands = registerCommands;
 const root_js_1 = require("./root.js");
 const shell_js_1 = require("./shell.js");
 const register_sdk_commands_js_1 = require("./sdk/register-sdk-commands.js");
+const status_js_1 = require("./status.js");
 const register_thread_commands_js_1 = require("./thread/register-thread-commands.js");
 function registerCommands(program) {
     (0, root_js_1.registerRootCommand)(program);
+    (0, status_js_1.registerStatusCommand)(program);
     (0, register_thread_commands_js_1.registerThreadCommands)(program);
     (0, shell_js_1.registerShellCommand)(program);
     (0, register_sdk_commands_js_1.registerSdkCommands)(program);