accelr8 1.0.0 → 3.0.0

package/README.md

@@ -0,0 +1,118 @@
+# accelr8
+
+Collaborative ascii canvas in your terminal. A real CLI app: mouse-driven TUI,
+real multiplayer, and live cursors that glide as your friends move them.
+
+```
+   ('-.                                ('-.               _  .-')
+  ( OO ).-.                          _(  OO)             ( \( -O )
+  / . --. /    .-----.     .-----.  (,------.  ,--.       ,------.    .-----.
+  | \-.  \    '  .--./    '  .--./   |  .---'  |  |.-')   |   /`. '  /  .-.  \
+.-'-'  |  |   |  |('-.    |  |('-.   |  |      |  | OO )  |  /  | | |   \_.' /
+ \| |_.'  |  /_) |OO  )  /_) |OO  ) (|  '--.   |  |`-' |  |  |_.' |  /  .-. '.
+  |  .-.  |  ||  |`-'|   ||  |`-'|   |  .--'  (|  '---.'  |  .  '.' |  |   |  |
+  |  | |  | (_'  '--'\  (_'  '--'\   |  `---.  |      |   |  |\  \   \  '-'  /
+  `--' `--'    `-----'     `-----'   `------'  `------'   `--' '--'   `----''
+```
+
+## Install
+
+```bash
+npm install -g accelr8
+```
+
+## Use
+
+```bash
+accelr8                 # open the app
+accelr8 join XYMRAU     # jump straight into a friend's project
+accelr8 --name pat      # pick your display name (remembered)
+```
+
+Create a project in the **Projects** tab, paint on the **Canvas** by clicking
+and dragging (right-click erases), and grab the join code from the **Members**
+tab. Everyone in a project sees everyone else's cursor move live.
+
+```
+ accelr8   collaborative ascii canvas                               you ●
+  Projects     Canvas     Members                                  ● live
+────────────────────────────────────────────────────────────────────────
+ brush  █ ▓ ▒ ░ ● ◆ ★ ▲ ■ · # @ *  ⌫ erase                        clear
+┌─ canvas 100×30 ───────────────────────────────────────────────────────┐
+│      █                                                                 │
+│       █                    ▲ alice                                     │
+│        █                                                               │
+│                                       ▲ bob                            │
+└────────────────────────────────────────────────────────────────────────┘
+ landing page redesign  ·  code XYMRAU  ·  3 online      [tab] switch  [q] quit
+```
+
+### Controls
+
+| Input | Action |
+|---|---|
+| Mouse click | tabs, buttons, project rows, palette |
+| Click + drag on canvas | paint with the current brush |
+| Right-click on canvas | erase a cell |
+| `Tab` / `1` `2` `3` | switch tabs |
+| `q` / `Ctrl-C` | quit |
+
+## How the live cursors work
+
+The terminal reports mouse motion via ANSI escape sequences (any-event
+tracking, `ESC[?1003h`). The app:
+
+1. **Throttles** outgoing cursor positions to ~25/sec.
+2. **Interpolates** on the receiving side: each remote cursor lerps toward its
+   last reported position every frame (`x += (target - x) * 0.35`), so it
+   glides smoothly instead of teleporting between throttled updates.
+
+Sparse sends plus client-side smoothing is what makes it feel live.
+
+## Sync server
+
+By default the CLI talks to the hosted sync server (a Cloudflare Worker with a
+Durable Object, source in `worker/`). You can point it anywhere:
+
+```bash
+accelr8 --server ws://localhost:8787      # or export ACCELR8_SERVER=...
+```
+
+### Self-hosting
+
+```bash
+accelr8 serve                 # starts a sync server on :8787
+accelr8 serve --port 9000     # custom port
+```
+
+Expose it beyond your machine with a quick tunnel:
+
+```bash
+cloudflared tunnel --url http://localhost:8787
+# friends then run: accelr8 --server wss://something.trycloudflare.com
+```
+
+Deploy your own copy of the hosted worker:
+
+```bash
+cd worker && npx wrangler deploy
+```
+
+## Development
+
+```bash
+npm install
+npm run dev              # run the TUI from source
+npm run serve            # run the sync server from source
+npm run smoketest        # headless two-client sync test (needs a server)
+npm run rendertest       # headless frame dumps of every screen
+npm run build            # bundle dist/cli.js
+```
+
+Layout:
+
+- `src/protocol.ts` shared wire types + constants (fixed 100×30 logical canvas)
+- `src/cli.ts` entry point, arg parsing
+- `src/client.ts` the TUI: mouse/keyboard, flicker-free rendering, cursor lerp
+- `src/server.ts` self-host sync server (Node, `ws`)
+- `worker/` hosted sync server (Cloudflare Worker + Durable Object)

package/dist/chunks/agentcli-ZI2O7ID7.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+import {
+  DEFAULT_MODEL,
+  addAccount,
+  defaultHandle,
+  detectClaudeCode,
+  detectEnvKeys,
+  loadAccounts,
+  removeAccount,
+  verifyAccount
+} from "./chunk-3JNUWI22.js";
+
+// src/agentcli.ts
+import { createInterface } from "node:readline";
+function ask(q, opts) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  if (opts?.hidden) {
+    const out = process.stdout;
+    rl._writeToOutput = (s) => {
+      if (s.includes("\n")) out.write("\n");
+      else out.write("*");
+    };
+  }
+  return new Promise((res) => rl.question(q, (a) => {
+    rl.close();
+    res(a.trim());
+  }));
+}
+function select(title, choices) {
+  const out = process.stdout;
+  const stdin = process.stdin;
+  if (!stdin.isTTY) return Promise.resolve(choices[0].value);
+  return new Promise((resolve) => {
+    let idx = 0;
+    out.write(title + "\n");
+    const draw = (first) => {
+      if (!first) out.write(`\x1B[${choices.length}A`);
+      out.write("\x1B[J");
+      for (let i = 0; i < choices.length; i++) {
+        const c = choices[i];
+        const hint = c.hint ? `  \x1B[2m${c.hint}\x1B[0m` : "";
+        if (i === idx) out.write(`\x1B[36m\u276F ${c.label}\x1B[0m${hint}
+`);
+        else out.write(`  ${c.label}${hint}
+`);
+      }
+    };
+    draw(true);
+    stdin.setRawMode(true);
+    stdin.resume();
+    const onData = (buf) => {
+      const s = buf.toString();
+      if (s === "\x1B[A" || s === "k") {
+        idx = (idx - 1 + choices.length) % choices.length;
+        draw(false);
+      } else if (s === "\x1B[B" || s === "j") {
+        idx = (idx + 1) % choices.length;
+        draw(false);
+      } else if (s === "\r" || s === "\n") {
+        done();
+        resolve(choices[idx].value);
+      } else if (s === "") {
+        done();
+        process.exit(130);
+      }
+    };
+    const done = () => {
+      stdin.removeListener("data", onData);
+      stdin.setRawMode(false);
+    };
+    stdin.on("data", onData);
+  });
+}
+var MODEL_CHOICES = {
+  anthropic: [
+    { label: "claude-opus-4-8", value: "claude-opus-4-8", hint: "most capable" },
+    { label: "claude-sonnet-5", value: "claude-sonnet-5", hint: "balanced" },
+    { label: "claude-haiku-4-5", value: "claude-haiku-4-5", hint: "fastest, cheapest" },
+    { label: "claude-fable-5", value: "claude-fable-5", hint: "most capable, premium" },
+    { label: "other\u2026", value: "__other__", hint: "type a model id" }
+  ],
+  openai: [
+    { label: "gpt-4o", value: "gpt-4o", hint: "flagship" },
+    { label: "gpt-4o-mini", value: "gpt-4o-mini", hint: "fast, cheap" },
+    { label: "o1", value: "o1", hint: "reasoning" },
+    { label: "other\u2026", value: "__other__", hint: "type a model id" }
+  ]
+};
+async function runAgentCli(args) {
+  const cmd = args[0] || "list";
+  if (cmd === "list") {
+    const accts = loadAccounts();
+    if (!accts.length) {
+      console.log("no agents connected. add one with:  accelr8 agent add");
+      return;
+    }
+    console.log("connected agents (this machine):");
+    for (const a of accts) console.log(`  \u2726${a.handle}  ${a.provider} \xB7 ${a.model}  ${a.auth.kind === "api_key" ? "(api key)" : "(claude login)"}`);
+    return;
+  }
+  if (cmd === "remove") {
+    const handle = args[1];
+    if (!handle) {
+      console.error("usage: accelr8 agent remove <handle>");
+      process.exit(1);
+    }
+    const acct = loadAccounts().find((a) => a.handle === handle);
+    if (!acct) {
+      console.error(`no agent named @${handle}`);
+      process.exit(1);
+    }
+    removeAccount(acct.id);
+    console.log(`removed \u2726${handle}`);
+    return;
+  }
+  if (cmd === "add") {
+    console.log("connect an AI account. it becomes a named agent anyone in your projects can @mention.");
+    console.log("your api key never leaves this machine.\n");
+    const cc = detectClaudeCode();
+    const env = detectEnvKeys();
+    const provider = await select("provider:", [
+      { label: "Anthropic (Claude)", value: "anthropic" },
+      { label: "OpenAI", value: "openai" }
+    ]);
+    let auth;
+    if (provider === "anthropic" && cc.available) {
+      const how = await select("\nhow should this agent authenticate?", [
+        { label: "Use my Claude Code login", value: "login", hint: "runs on your Claude subscription" },
+        { label: "Paste an API key", value: "key", hint: "billed per token via the console" }
+      ]);
+      if (how === "login") auth = { kind: "claude_code_login" };
+      else auth = { kind: "api_key", apiKey: await ask("\npaste your anthropic api key: ", { hidden: true }) };
+    } else {
+      const envKey = provider === "anthropic" ? env.anthropic : env.openai;
+      const key = envKey || await ask(`
+paste your ${provider} api key: `, { hidden: true });
+      if (envKey) console.log("using key from environment.");
+      auth = { kind: "api_key", apiKey: key };
+    }
+    const suggested = defaultHandle(process.env.USER || "my", provider);
+    const handle = await ask(`
+name your agent (${suggested}): `) || suggested;
+    let model;
+    if (auth.kind === "claude_code_login") {
+      model = DEFAULT_MODEL.anthropic;
+      console.log("model: follows your Claude Code setup");
+    } else {
+      const picked = await select(`
+model for @${handle}:`, MODEL_CHOICES[provider]);
+      model = picked === "__other__" ? await ask("model id: ") || DEFAULT_MODEL[provider] : picked;
+    }
+    const mode = await select("\nhow autonomous should it be?", [
+      { label: "approve", value: "approve", hint: "ask before each file write / command" },
+      { label: "plan", value: "plan", hint: "propose only, never acts" },
+      { label: "auto", value: "auto", hint: "run freely (trusted rooms only)" }
+    ]);
+    let acct;
+    try {
+      acct = addAccount({ provider, auth, handle, model, mode });
+    } catch (e) {
+      console.error("could not add agent:", e instanceof Error ? e.message : e);
+      process.exit(1);
+    }
+    process.stdout.write("verifying... ");
+    const v = await verifyAccount(acct);
+    console.log(v.ok ? "ok" : `warning: ${v.message}`);
+    console.log(`
+\u2726${handle} is ready. open a project and it joins automatically.`);
+    return;
+  }
+  console.error("usage: accelr8 agent [list|add|remove <handle>]");
+  process.exit(1);
+}
+export {
+  runAgentCli
+};