cloach 0.1.0

package/README.md

@@ -0,0 +1,50 @@
+# cloach
+
+AI pair-programmer coach for Claude Code. Launches Claude Code inside a tmux session with a real-time coaching side panel that evaluates your prompts and provides educational commentary as you work.
+
+## Install
+
+```bash
+npm install -g cloach
+```
+
+`cloach` ships native binaries for macOS and Linux as platform-specific optional dependencies. npm picks the right one at install time — no postinstall download, no compilation.
+
+| Platform | Architecture |
+|----------|--------------|
+| macOS    | arm64, x64   |
+| Linux    | x64, arm64   |
+
+## Runtime requirements
+
+`cloach` is a launcher — it does not bundle these. You must have them on your `PATH`:
+
+- [`tmux`](https://github.com/tmux/tmux) — the coaching panel runs in a tmux pane next to Claude Code
+- [`claude`](https://docs.anthropic.com/en/docs/claude-code) — the Claude Code CLI
+
+## Usage
+
+```bash
+# Launch a coaching session in the current directory
+cloach
+
+# Launch with debug logging
+cloach -d
+
+# Launch in a specific directory
+cloach -c /path/to/project
+
+# Show coaching progress stats
+cloach progress
+```
+
+Run `cloach --help` for the full command list.
+
+## Links
+
+- Source: <https://github.com/roihala/coach>
+- Issues: <https://github.com/roihala/coach/issues>
+
+## License
+
+MIT

package/bin/cloach.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+// Cloach launcher.
+// Resolves the platform-specific sub-package installed by npm via
+// optionalDependencies, then execs its bundled binary with the same argv.
+
+const { spawnSync } = require("node:child_process");
+const path = require("node:path");
+const fs = require("node:fs");
+
+const PLATFORM = process.platform;
+const ARCH = process.arch;
+
+// Map Node platform/arch tuples to the cloach sub-package that ships
+// the matching binary. Keep in sync with the matrix in the release workflow.
+const PACKAGES = {
+  "darwin-arm64": "cloach-darwin-arm64",
+  "darwin-x64": "cloach-darwin-x64",
+  "linux-x64": "cloach-linux-x64",
+  "linux-arm64": "cloach-linux-arm64",
+};
+
+const key = `${PLATFORM}-${ARCH}`;
+const pkg = PACKAGES[key];
+
+if (!pkg) {
+  console.error(
+    `cloach: unsupported platform ${key}. Supported: ${Object.keys(PACKAGES).join(", ")}.`
+  );
+  console.error(
+    "cloach: see https://github.com/roihala/coach for native install instructions."
+  );
+  process.exit(1);
+}
+
+let binaryPath;
+try {
+  // Resolve the sub-package's package.json, then locate its bundled binary.
+  // require.resolve handles npm/pnpm/yarn hoisting transparently.
+  const pkgJsonPath = require.resolve(`${pkg}/package.json`);
+  binaryPath = path.join(path.dirname(pkgJsonPath), "bin", "cloach");
+} catch (err) {
+  console.error(
+    `cloach: platform package "${pkg}" is not installed.`
+  );
+  console.error(
+    "cloach: this usually means npm skipped it during install — try reinstalling with --include=optional."
+  );
+  process.exit(1);
+}
+
+if (!fs.existsSync(binaryPath)) {
+  console.error(`cloach: binary missing at ${binaryPath}.`);
+  process.exit(1);
+}
+
+const result = spawnSync(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+});
+
+if (result.error) {
+  console.error(`cloach: failed to launch binary: ${result.error.message}`);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 0);

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "cloach",
+  "version": "0.1.0",
+  "description": "AI pair-programmer coach for Claude Code — launches Claude Code in tmux with a real-time coaching side panel.",
+  "bin": {
+    "cloach": "bin/cloach.js"
+  },
+  "files": [
+    "bin/cloach.js",
+    "README.md"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "coach",
+    "tmux",
+    "cli",
+    "ai-pair-programming"
+  ],
+  "homepage": "https://github.com/roihala/coach",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/roihala/coach.git"
+  },
+  "bugs": {
+    "url": "https://github.com/roihala/coach/issues"
+  },
+  "author": "roihala",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "cloach-darwin-arm64": "0.1.0",
+    "cloach-darwin-x64": "0.1.0",
+    "cloach-linux-x64": "0.1.0",
+    "cloach-linux-arm64": "0.1.0"
+  }
+}