forge-cockpit 0.1.2

package/README.md

@@ -0,0 +1,63 @@
+# forge-cockpit
+
+An AI coding agent with a **browser cockpit** — the same agent you drive from the
+terminal, plus platform dashboards and one-click integrations
+(GitHub · Jira · Sentry · Slack · Gmail · Google Calendar). **Bring your own model
+API key.** A fork of [Forge](https://github.com/antinomyhq/forge), Apache-2.0.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/LeyouHong/forge-cockpit/main/docs/img/cockpit.png" alt="forge-cockpit web UI" width="820">
+</p>
+
+## Install
+
+```bash
+npm install -g forge-cockpit
+# or run without installing:
+npx forge-cockpit --help
+```
+
+On install, the prebuilt binary for your platform (macOS arm64, Linux x64/arm64,
+Windows x64) is downloaded from the matching GitHub Release — nothing is compiled
+on your machine. (Install with scripts enabled, i.e. not `--ignore-scripts`.)
+
+## Bring your own key
+
+No hosted account is bundled or required. On first run, log in with **your own**
+model provider key:
+
+```bash
+forge-cockpit provider login     # pick OpenAI / Anthropic / OpenRouter / …
+forge-cockpit                    # interactive agent in your terminal
+forge-cockpit serve              # open the browser cockpit
+```
+
+## The cockpit
+
+`forge-cockpit serve` opens a local browser UI (bound to `127.0.0.1`, gated by a
+per-run token):
+
+- **💬 Chat** — the full agent: streaming responses, tool-call chips, resumable
+  turns (refresh mid-run without losing progress).
+- **📋 Dashboard** — read-only boards over your connected platforms.
+- **🧩 Integrations** — one-click connect to MCP servers (read **and** write).
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/LeyouHong/forge-cockpit/main/docs/img/dashboard.png" alt="Dashboard" width="820">
+</p>
+<p align="center">
+  <img src="https://raw.githubusercontent.com/LeyouHong/forge-cockpit/main/docs/img/integrations.png" alt="Integrations" width="820">
+</p>
+
+## Docs & source
+
+Full documentation, architecture, and build-from-source instructions:
+**https://github.com/LeyouHong/forge-cockpit**
+
+## Notes
+
+- **Linux:** the binary dynamically links OpenSSL (`libssl`) for IMAP email
+  support; present on virtually all distros (`libssl3` if missing).
+- **Intel Mac (x64):** no prebuilt binary yet — build from source.
+- License: Apache-2.0. A community fork; "Forge" and "forgecode" are trademarks
+  of their respective owners, and this package is not affiliated with them.

package/bin/forge-cockpit.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+'use strict';
+
+// Launcher: exec the `forge` binary that postinstall.js downloaded next to this
+// file (bin/forge or bin/forge.exe), forwarding all args and the exit code.
+
+const { spawnSync } = require('node:child_process');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const exe = process.platform === 'win32' ? 'forge.exe' : 'forge';
+const bin = path.join(__dirname, exe);
+
+if (!fs.existsSync(bin)) {
+  console.error(
+    'forge-cockpit: the binary was not downloaded.\n' +
+      'This usually means install scripts were disabled. Reinstall with scripts enabled:\n' +
+      '  npm install -g forge-cockpit\n' +
+      'or build from source: https://github.com/LeyouHong/forge-cockpit#build-from-source'
+  );
+  process.exit(1);
+}
+
+const result = spawnSync(bin, process.argv.slice(2), { stdio: 'inherit' });
+if (result.error) {
+  console.error(`forge-cockpit: failed to launch binary: ${result.error.message}`);
+  process.exit(1);
+}
+process.exit(result.status === null ? 1 : result.status);

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "forge-cockpit",
+  "version": "0.1.2",
+  "description": "An AI coding agent with a browser cockpit (dashboards + one-click integrations). Bring your own model API key. A fork of Forge (Apache-2.0).",
+  "keywords": [
+    "ai",
+    "agent",
+    "coding-agent",
+    "cli",
+    "mcp",
+    "dashboard",
+    "forge"
+  ],
+  "homepage": "https://github.com/LeyouHong/forge-cockpit#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LeyouHong/forge-cockpit.git"
+  },
+  "license": "Apache-2.0",
+  "bin": {
+    "forge-cockpit": "bin/forge-cockpit.js"
+  },
+  "scripts": {
+    "postinstall": "node postinstall.js"
+  },
+  "files": [
+    "bin/forge-cockpit.js",
+    "postinstall.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}

package/postinstall.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+'use strict';
+
+// Downloads the platform-specific `forge` binary from this version's GitHub
+// Release into ./bin, at install time. Single npm package, no per-platform
+// packages. Requires Node >=18 (uses global fetch, which follows redirects).
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { version } = require('./package.json');
+
+const REPO = 'LeyouHong/forge-cockpit';
+
+// host key -> release asset platform suffix
+const PLATFORMS = {
+  'darwin arm64': 'darwin-arm64',
+  'linux x64': 'linux-x64',
+  'linux arm64': 'linux-arm64',
+  'win32 x64': 'win32-x64',
+};
+
+async function main() {
+  const key = `${process.platform} ${process.arch}`;
+  const suffix = PLATFORMS[key];
+  if (!suffix) {
+    console.warn(
+      `forge-cockpit: no prebuilt binary for "${key}". ` +
+        `Supported: ${Object.keys(PLATFORMS).join(', ')}. ` +
+        `You can still build from source: https://github.com/${REPO}#build-from-source`
+    );
+    return; // don't hard-fail the install
+  }
+
+  const isWin = process.platform === 'win32';
+  const ext = isWin ? '.exe' : '';
+  const asset = `forge-cockpit-${suffix}${ext}`;
+  const url = `https://github.com/${REPO}/releases/download/release-v${version}/${asset}`;
+
+  const binDir = path.join(__dirname, 'bin');
+  const dest = path.join(binDir, `forge${ext}`);
+  fs.mkdirSync(binDir, { recursive: true });
+
+  process.stdout.write(`forge-cockpit: downloading ${asset} (v${version})… `);
+  let lastErr;
+  for (let attempt = 1; attempt <= 3; attempt++) {
+    try {
+      const res = await fetch(url, { redirect: 'follow' });
+      if (!res.ok) throw new Error(`HTTP ${res.status} for ${url}`);
+      const buf = Buffer.from(await res.arrayBuffer());
+      fs.writeFileSync(dest, buf);
+      if (!isWin) fs.chmodSync(dest, 0o755);
+      console.log('done.');
+      return;
+    } catch (e) {
+      lastErr = e;
+      if (attempt < 3) await new Promise((r) => setTimeout(r, 1500 * attempt));
+    }
+  }
+  console.log('failed.');
+  console.error(
+    `forge-cockpit: could not download the binary (${lastErr && lastErr.message}).\n` +
+      `Check your network, or install with scripts enabled (not --ignore-scripts).\n` +
+      `Manual: download ${url} to ${dest}`
+  );
+  // Non-fatal: leave the launcher to report a clear error if run without a binary.
+}
+
+main().catch((e) => {
+  console.error('forge-cockpit: postinstall error:', e && e.message ? e.message : e);
+});