@algochad/archcoder 2.0.2

package/README.md

@@ -0,0 +1,113 @@
+# @algochad/archcoder
+
+Run [OpenCode](https://opencode.ai) in your browser. Install the CLI, open `localhost:3000`, done. Works on desktop browsers, tablets, and phones as a PWA.
+
+[![Discord](https://img.shields.io/badge/Discord-join.svg?style=flat&labelColor=100F0F&color=8B7EC8&logo=discord&logoColor=FFFCF0)](https://discord.gg/uPECDcCQN)
+
+ArchCoder is a private project. For support, contact [@algochad](https://x.com/algochad).
+
+## Install
+
+```bash
+# Quick install
+curl -fsSL https://archcoder.archlast.com/cli | bash
+
+# Or using your preferred package manager
+npm install -g @algochad/archcoder
+pnpm add -g @algochad/archcoder
+bun add -g @algochad/archcoder
+yarn global add @algochad/archcoder
+```
+
+> **Prerequisites:** [OpenCode CLI](https://opencode.ai) installed, Node.js 20+.
+
+## Usage
+
+```bash
+archcoder                          # Start on port 3000
+archcoder --port 8080              # Custom port
+archcoder --ui-password secret     # Password-protect UI
+archcoder tunnel help              # Tunnel lifecycle commands
+archcoder tunnel providers         # Show provider capabilities
+archcoder tunnel profile add --provider cloudflare --mode managed-remote --name prod-main --hostname app.example.com --token <token>
+archcoder tunnel start --profile prod-main
+archcoder tunnel start --provider cloudflare --mode quick --qr
+archcoder tunnel start --provider cloudflare --mode managed-local --config ~/.cloudflared/config.yml
+archcoder tunnel status --all      # Show tunnel state across instances
+archcoder tunnel stop --port 3000  # Stop tunnel only (server stays running)
+archcoder logs                     # Follow latest instance logs
+OPENCODE_PORT=4096 OPENCODE_SKIP_START=true archcoder                    # Connect to external OpenCode server
+OPENCODE_HOST=https://myhost:4096 OPENCODE_SKIP_START=true archcoder  # Connect via custom host/HTTPS
+archcoder stop                     # Stop server
+archcoder update                   # Update to latest version
+```
+
+### Tunnel behavior notes
+
+- One active tunnel per running ArchCoder instance (port).
+- Starting a different tunnel mode/provider on the same instance replaces the active tunnel.
+- Replacing or stopping a tunnel revokes existing connect links and invalidates remote tunnel sessions.
+- Connect links are one-time tokens; generating a new link revokes the previous unused link.
+
+**Optional env vars:**
+```yaml
+environment:
+  UI_PASSWORD: your_secure_password
+  ARCHCODER_TUNNEL_MODE: quick # quick | managed-remote | managed-local
+  ARCHCODER_TUNNEL_PROVIDER: cloudflare
+```
+
+For `managed-remote` mode, also set:
+
+```yaml
+environment:
+  ARCHCODER_TUNNEL_MODE: managed-remote
+  ARCHCODER_TUNNEL_HOSTNAME: app.example.com
+  ARCHCODER_TUNNEL_TOKEN: <token>
+```
+
+For `managed-local` mode, you can set:
+
+```yaml
+environment:
+  ARCHCODER_TUNNEL_MODE: managed-local
+  ARCHCODER_TUNNEL_CONFIG: /home/archcoder/.cloudflared/config.yml
+```
+
+Managed-local path note: `ARCHCODER_TUNNEL_CONFIG` must use a container path under `/home/archcoder/...`. If the config file references `credentials-file`, ensure that JSON path is also mounted and reachable inside the container.
+
+**Data directory:** mount `data/` for persistent storage. Ensure permissions:
+```bash
+mkdir -p data/archcoder data/opencode/share data/opencode/config data/ssh
+chown -R 1000:1000 data/
+```
+
+</details>
+
+<details>
+<summary>Background & daemon mode</summary>
+
+```bash
+archcoder             # Runs in background by default
+archcoder stop        # Stop background server
+```
+
+</details>
+
+## What makes the web version special
+
+- **Remote access** - Cloudflare tunnel with QR onboarding. Scan from your phone, start coding.
+- **Mobile-first PWA** - optimized chat controls, keyboard-safe layouts, drag-to-reorder projects
+- **Background notifications** - know when your agent finishes, even from another tab
+- **Self-update** - update and restart from the UI, server settings stay intact
+- **Cross-tab tracking** - session activity stays in sync across browser tabs
+
+- Cloudflare tunnel access with quick, managed-remote, and managed-local modes
+- One-scan onboarding with tunnel QR + password URL helpers
+- Mobile-first experience: optimized chat controls, keyboard-safe layouts, and attachment-friendly UI
+- Background notifications plus reliable cross-tab session activity tracking
+- Built-in self-update + restart flow that keeps your server settings intact
+
+## License
+
+MIT

package/bin/cli-entry.js

@@ -0,0 +1,55 @@
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath, pathToFileURL } from 'url';
+
+function normalizeCliEntryPath(filePath, realpath = fs.realpathSync) {
+  if (typeof filePath !== 'string' || filePath.trim().length === 0) {
+    return null;
+  }
+
+  const resolvedPath = path.resolve(filePath);
+  try {
+    return realpath(resolvedPath);
+  } catch {
+    return resolvedPath;
+  }
+}
+
+function isModuleCliExecution(
+  entryPath = process.argv[1],
+  moduleUrl,
+  realpath = fs.realpathSync,
+  expectedBinName,
+) {
+  if (typeof entryPath !== 'string' || entryPath.trim().length === 0) {
+    return false;
+  }
+  if (typeof moduleUrl !== 'string' || moduleUrl.trim().length === 0) {
+    return false;
+  }
+
+  try {
+    const normalizedEntryPath = normalizeCliEntryPath(entryPath, realpath);
+    const normalizedModulePath = normalizeCliEntryPath(fileURLToPath(moduleUrl), realpath);
+    if (!normalizedEntryPath || !normalizedModulePath) {
+      return false;
+    }
+    if (pathToFileURL(normalizedEntryPath).href === pathToFileURL(normalizedModulePath).href) {
+      return true;
+    }
+
+    if (typeof expectedBinName === 'string' && expectedBinName.trim().length > 0) {
+      const parsedEntryName = path.parse(normalizedEntryPath).name.toLowerCase();
+      return parsedEntryName === expectedBinName.trim().toLowerCase();
+    }
+
+    return false;
+  } catch {
+    return false;
+  }
+}
+
+export {
+  normalizeCliEntryPath,
+  isModuleCliExecution,
+};

package/bin/cli-output.js

@@ -0,0 +1,145 @@
+/**
+ * CLI output formatting adapter.
+ *
+ * Wraps @clack/prompts for structured, beautiful terminal output.
+ * Custom formatters (icons, redaction) live here to isolate the
+ * formatting dependency from the rest of the CLI.
+ */
+
+import {
+  intro,
+  outro,
+  log,
+  note,
+  box,
+  progress,
+  spinner,
+  confirm,
+  select,
+  text,
+  password,
+  cancel,
+  isCancel,
+} from '@clack/prompts';
+
+// ── Provider icons ──────────────────────────────────────────────
+
+const TUNNEL_PROVIDER_ICON = {
+  cloudflare: '☁',
+};
+
+function formatProviderWithIcon(provider) {
+  if (typeof provider !== 'string' || provider.trim().length === 0) {
+    return 'unknown';
+  }
+  const normalized = provider.trim().toLowerCase();
+  const icon = TUNNEL_PROVIDER_ICON[normalized];
+  return icon ? `${icon} ${normalized}` : normalized;
+}
+
+// ── Status-aware log dispatch ───────────────────────────────────
+
+/**
+ * Print a status-tagged message using clack log primitives.
+ *
+ * @param {'success'|'warning'|'error'|'info'|'neutral'} status
+ * @param {string} message  Primary line
+ * @param {string} [detail] Optional dim secondary line appended after newline
+ */
+function logStatus(status, message, detail) {
+  const full = detail ? `${message}\n${detail}` : message;
+  switch (status) {
+    case 'success':
+      log.success(full);
+      break;
+    case 'warning':
+      log.warn(full);
+      break;
+    case 'error':
+      log.error(full);
+      break;
+    case 'info':
+    case 'neutral':
+    default:
+      log.info(full);
+      break;
+  }
+}
+
+// ── TTY detection ───────────────────────────────────────────────
+
+/**
+ * Whether both stdout and stdin are interactive TTYs.
+ * Prompts must be disabled when stdin is piped (e.g. --token-stdin).
+ */
+const isTTY = Boolean(process.stdout?.isTTY) && Boolean(process.stdin?.isTTY);
+
+function isJsonMode(options) {
+  return Boolean(options?.json);
+}
+
+function isQuietMode(options) {
+  return Boolean(options?.quiet);
+}
+
+function shouldRenderHumanOutput(options) {
+  return !isJsonMode(options) && !isQuietMode(options);
+}
+
+function canPrompt(options) {
+  return shouldRenderHumanOutput(options) && isTTY;
+}
+
+function createSpinner(options) {
+  return canPrompt(options) ? spinner() : null;
+}
+
+async function createProgress(options, config) {
+  return canPrompt(options) ? progress(config) : null;
+}
+
+function printJson(payload) {
+  const base = payload && typeof payload === 'object' && !Array.isArray(payload)
+    ? { ...payload }
+    : { data: payload };
+
+  const messages = Array.isArray(base.messages) ? base.messages : undefined;
+  const hasWarning = Boolean(messages?.some((entry) => entry?.level === 'warning'));
+  const hasError = Boolean(messages?.some((entry) => entry?.level === 'error'));
+  const normalizedStatus = base.status === 'ok' || base.status === 'warning' || base.status === 'error'
+    ? base.status
+    : (hasError ? 'error' : (hasWarning ? 'warning' : 'ok'));
+
+  const output = {
+    status: normalizedStatus,
+    ...base,
+  };
+
+  process.stdout.write(`${JSON.stringify(output, null, 2)}\n`);
+}
+
+export {
+  intro,
+  outro,
+  log,
+  note,
+  box,
+  progress,
+  spinner,
+  confirm,
+  select,
+  text,
+  password,
+  cancel,
+  isCancel,
+  isTTY,
+  isJsonMode,
+  isQuietMode,
+  shouldRenderHumanOutput,
+  canPrompt,
+  createSpinner,
+  createProgress,
+  printJson,
+  formatProviderWithIcon,
+  logStatus,
+};