agentspace-connect 0.1.0

package/README.md

@@ -0,0 +1,26 @@
+# agentspace
+
+Connect your AI coding agents to an [AgentSpace](https://github.com/IndicatedP/agentspace) wallboard.
+
+## Usage
+
+```bash
+npx agentspace
+```
+
+The interactive wizard will prompt for:
+
+- **AgentSpace URL** — your deployment (defaults to `http://localhost:3000`)
+- **Space code** — shown on the admin page
+- **Owner name** — your name
+- **Agent name** — how this agent appears on the wallboard
+- **Tool** — `claude` or `codex`
+- **Claude scope** — `global` (all sessions) or `project` (current directory only)
+- **Space password** — the view password for the space
+
+It then installs the appropriate hooks/config so your agent reports activity to the wallboard.
+
+## Requirements
+
+- Node.js 18+
+- `bash`, `curl`, and `jq` available in your terminal

package/bin/agentspace.mjs

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+import { createInterface } from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+import { spawn } from "node:child_process";
+
+function stripTrailingSlash(input) {
+  return input.replace(/\/+$/, "");
+}
+
+async function promptHidden(prompt) {
+  return new Promise((resolve, reject) => {
+    let value = "";
+    let rawEnabled = false;
+
+    const cleanup = () => {
+      stdin.removeListener("data", onData);
+      if (rawEnabled && stdin.isTTY) {
+        stdin.setRawMode(false);
+      }
+      stdin.pause();
+    };
+
+    const onData = (chunk) => {
+      const ch = String(chunk);
+      if (ch === "\u0003") {
+        cleanup();
+        reject(new Error("Cancelled"));
+        return;
+      }
+      if (ch === "\r" || ch === "\n" || ch === "\u0004") {
+        cleanup();
+        stdout.write("\n");
+        resolve(value.trim());
+        return;
+      }
+      if (ch === "\u007f") {
+        if (value.length > 0) {
+          value = value.slice(0, -1);
+          stdout.write("\b \b");
+        }
+        return;
+      }
+      value += ch;
+      stdout.write("*");
+    };
+
+    stdout.write(prompt);
+    stdin.resume();
+    if (stdin.isTTY) {
+      stdin.setRawMode(true);
+      rawEnabled = true;
+    }
+    stdin.setEncoding("utf8");
+    stdin.on("data", onData);
+  });
+}
+
+function required(value, field) {
+  const out = value.trim();
+  if (!out) throw new Error(`Missing ${field}`);
+  return out;
+}
+
+async function run() {
+  if (!stdin.isTTY || !stdout.isTTY) {
+    throw new Error("Interactive terminal required. Run `npx agentspace` in a normal shell.");
+  }
+
+  const rl = createInterface({ input: stdin, output: stdout });
+
+  try {
+    const baseUrlInput = await rl.question("AgentSpace URL [http://localhost:3000]: ");
+    const baseUrl = stripTrailingSlash(baseUrlInput.trim() || "http://localhost:3000");
+
+    const spaceCode = required(await rl.question("Space code: "), "space code");
+    const owner = required(await rl.question("Owner name: "), "owner name");
+    const agentName = required(await rl.question("Agent name: "), "agent name");
+
+    let tool = (await rl.question("Tool (claude/codex) [claude]: ")).trim().toLowerCase();
+    if (tool !== "claude" && tool !== "codex") tool = "claude";
+
+    let mode = "global";
+    if (tool === "claude") {
+      const modeInput = (await rl.question("Claude scope (global/project) [global]: "))
+        .trim()
+        .toLowerCase();
+      if (modeInput === "project") mode = "project";
+    }
+
+    rl.close();
+
+    const password = required(await promptHidden("Space password: "), "space password");
+
+    const connectRes = await fetch(`${baseUrl}/api/connect`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({
+        spaceCode,
+        password,
+        owner,
+        agentName,
+        tool,
+        mode,
+      }),
+    });
+
+    const payload = await connectRes
+      .json()
+      .catch(() => null);
+
+    if (!connectRes.ok || !payload?.setupUrl) {
+      const msg = payload?.error ?? `Connect failed (${connectRes.status})`;
+      throw new Error(msg);
+    }
+
+    const setupUrl = payload.setupUrl;
+    const escaped = setupUrl.replace(/'/g, "'\\''");
+    const installCmd = `bash <(curl -fsSL '${escaped}')`;
+
+    console.log("");
+    console.log(
+      `Connecting ${owner} to ${payload.space?.name ?? "space"} (${payload.space?.slug ?? ""}) as ${payload.agent?.name ?? agentName}...`,
+    );
+    console.log("");
+
+    const exitCode = await new Promise((resolve) => {
+      const child = spawn("bash", ["-lc", installCmd], { stdio: "inherit" });
+      child.on("close", (code) => resolve(code ?? 1));
+    });
+
+    if (exitCode !== 0) {
+      throw new Error("Setup script failed");
+    }
+
+    console.log("");
+    console.log("Connected. Start a new session and activity should appear in AgentSpace.");
+  } finally {
+    rl.close();
+    stdin.pause();
+  }
+}
+
+run().catch((err) => {
+  console.error(`\nError: ${err?.message ?? String(err)}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "agentspace-connect",
+  "version": "0.1.0",
+  "description": "Connect your AI coding agents to an AgentSpace wallboard",
+  "type": "module",
+  "bin": {
+    "agentspace-connect": "./bin/agentspace.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "agentspace",
+    "ai",
+    "agents",
+    "claude",
+    "codex",
+    "wallboard",
+    "cli"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/IndicatedP/agentspace.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/IndicatedP/agentspace",
+  "files": [
+    "bin/"
+  ]
+}