@lardexx/arenacode 2.11.1 → 2.11.3

package/README.md

@@ -17,13 +17,13 @@ you ──▶ arenacode CLI ──▶ arena-bridge ──▶ agent
 
 ```bash
 npm install -g @lardexx/arenacode
-arenacode --version           # 2.5.2 (the bridge protocol version this client speaks)
+arenacode --version           # the version of the installed package
 ```
 
 Or without installing:
 
 ```bash
-npx @lardexx/arenacode ask "list the files in my folder"
+npx @lardexx/arenacode         # opens the interface (needs a terminal)
 ```
 
 Published as [`@lardexx/arenacode`](https://www.npmjs.com/package/@lardexx/arenacode) — the bare name `arenacode`
@@ -42,10 +42,12 @@ rebuilt from opencode 1.19.5's own source (`packages/tui/src/component/prompt`,
 
 ```bash
 arenacode            # opens the TUI on a terminal; on the very first run it asks for URL + key first
-arenacode ui         # same thing, explicitly
-arenacode chat       # the plain line-by-line client, if you really want one
 ```
 
+The client has **one entry point**: `arenacode`. There are no subcommands — setup, settings, Stop and the bridge
+inspection all live inside the interface (the settings live behind `/settings` or the command palette). Anything else on the command line is refused
+with `command removed: <name>` and exit code 2.
+
 Home screen — two-tone block wordmark, all lowercase (single-storey `a`, stem-and-arm `r`), centred prompt, tips, and the folder you
 started in at the bottom left:
 
@@ -181,7 +183,7 @@ terminal **Accessibility** (input) and **Screen Recording** (pixels) in System S
 On macOS/Linux the accessibility tree is not read: `ui state` returns windows and geometry as elements.
 
 **Ask and Proceed / Proceed.** The desktop's Settings switch, `ctrl+x a` here (also `/ask`, `/proceed`,
-`--proceed`, and `arenacode config set approval proceed`). The default, **Ask and Proceed**, asks before commands,
+`--proceed`, and the Settings panel). The default, **Ask and Proceed**, asks before commands,
 file changes and plans; in Computer mode it asks once, on the plan, and after that the commands run on their own
 while administrator commands still ask. **Proceed** approves its own plan, runs commands and installations and
 writes files without asking: turning it on shows the desktop's own warning (*"Pericolo: modalità Proceed"*).
@@ -198,46 +200,30 @@ terminal confirmation, `--confirm-writes` adds one for writes and removals.
 ## Quick start
 
 ```bash
-# 1. point the client at your bridge (URL + API key come from the bridge's runtime/connection.txt)
-arenacode init
-
-# 2. open the TUI in the folder you want the agent to work on — just cd there first
-cd ~/progetto && arenacode
+# 1. cd into the folder you want the agent to work on
+cd ~/progetto
 
-# 3. or stay in the plain CLI
-arenacode ask "read package.json and add a lint script"
-arenacode chat
+# 2. open the client
+arenacode
 ```
 
-`init` saves the URL and the API key (the folder is never stored — arenacode works in the directory you start
-it from), then tests `/health` and `/auth/check` so you know the
-bridge accepts the key before you send anything.
+On the first run the interface asks for the bridge URL and the API key (both are in the bridge's
+`runtime/connection.txt`), saves them, and tests `/health` and `/auth/check` so you know the bridge accepts the
+key before you send anything. The folder is never stored: arenacode works in the directory you start it from.
+Later, `/settings` (or the command palette, `ctrl+p`) reopens them inside the interface.
 
 ## Commands
 
 | Command | What it does |
 |---|---|
-| `arenacode init` | configure URL and API key; test the connection |
-| `arenacode config [show\|path\|set <k> <v>\|clear]` | read or change the saved configuration |
-| `arenacode ping` | `/health` + `/auth/check`: version, public URL, queue, key |
-| `arenacode doctor` | local checks: node, platform, folder, git, bridge, API key |
-| `arenacode` (no args) | full-screen TUI — the default on a terminal |
-| `arenacode ui` | full-screen TUI, explicitly |
-| `arenacode ask "<instruction>"` | one task, streamed timeline, exit when it finishes |
-| `arenacode chat` | interactive session (`/help` shows the in-session commands) |
-| `arenacode stop [task-id]` | Stop: cancels the turn and the queued tasks on the bridge |
-| `arenacode handshake` | vision/handshake check task, like the client's |
-
-**Inspect the bridge**
+| `arenacode` | the interface: timeline, input box, cards, settings, Stop, bridge inspection |
+| `arenacode --help` | the options below |
+| `arenacode --version` | the version of the installed package |
 
-| Command | What it does |
-|---|---|
-| `arenacode tasks [state]` | task queue (`all`, `claimable`, `pending`, `claimed`, `done`, `error`) |
-| `arenacode status <task-id>` | state, claimant, result of one task |
-| `arenacode events <task-id>` | replayed timeline of a task |
-| `arenacode files [path]` | bridge workspace listing (`GET /fs`) |
-| `arenacode cat <path>` | preview a text file in the bridge workspace (`GET /file`) |
-| `arenacode attach <file…>` | upload files into the bridge workspace (`POST /upload`) |
+Everything else — URL and API key, settings, the task queue, task state and timeline, files on the bridge,
+file uploads, Stop — is inside the interface. Up to 2.11.2 these were subcommands (`init`, `config`, `ping`,
+`doctor`, `ask`, `chat`, `ui`, `tasks`, `status`, `events`, `stop`, `files`, `cat`, `attach`, `handshake`);
+they were removed on request, and the terminal has to be interactive: in a pipe the client prints why and exits.
 
 **Options**
 
@@ -321,7 +307,6 @@ Pin it with any of:
 
 ```
 arenacode --shell zsh
-arenacode config set shell zsh
 /shell              # in the TUI: pick from the shells installed on this machine
 ```
 
@@ -359,7 +344,7 @@ release it on the bridge with `keys unbind <ID>`).
 
 ## Configuration
 
-`arenacode config path` prints the file:
+The file lives at:
 
 * Windows — `%APPDATA%\ArenaCode\config.json`
 * macOS / Linux — `~/.arenacode/config.json`
@@ -390,11 +375,11 @@ Environment variables override the file: `ARENACODE_URL`, `ARENACODE_KEY`, `AREN
 
 | Symptom | Fix |
 |---|---|
-| `auth failed: unauthorized` | wrong API key — `arenacode config set key <key>` (from `runtime/connection.txt`) |
+| `auth failed: unauthorized` | wrong API key — `/settings` in the interface, paste the key from `runtime/connection.txt` |
 | `403 device_mismatch` | key bound to another PC — on the bridge: `python3 bridge_server.py keys unbind <ID>` |
-| `bridge unreachable` | tunnel down or wrong URL — check `arenacode ping`, and `/health` on the bridge |
+| `bridge unreachable` | tunnel down or wrong URL — check `/health` on the bridge, then `/settings` in the interface |
 | agent never answers | the agent is not listening: run `bash listen.sh` in the bridge folder |
-| everything hangs after a turn | `--idle-timeout` closes the session; check `arenacode status <id>` |
+| everything hangs after a turn | `--idle-timeout` closes the session; the task state is in the interface |
 
 ## Development
 

package/docs/PUBLISHING.md

@@ -8,7 +8,7 @@ made the TUI unreachable without typing `ui`; a bare invocation now opens the in
 interface asks for URL + key instead of printing a dead-end notice.
 
 2.5.4 made the hints launch-aware: run through npx and every message prints the command you can actually paste
-(`npx @lardexx/arenacode init`), plus the one-line way to get the bare `arenacode` command.
+(`npx @lardexx/arenacode`), plus the one-line way to get the bare `arenacode` command.
 
 ```bash
 npm install -g @lardexx/arenacode     # then: arenacode

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lardexx/arenacode",
-  "version": "2.11.1",
+  "version": "2.11.3",
   "description": "Terminal client for ArenaCode: talks to an arena-bridge, streams the Agent Mode timeline, and runs local commands, file operations and computer automation on your PC (windows-use.dll on Windows, Xlib/XTest on Linux, osascript on macOS). Node port of the ArenaCode desktop client.",
   "license": "MIT",
   "type": "commonjs",
@@ -20,7 +20,7 @@
     "vendor/"
   ],
   "scripts": {
-    "test": "node test/shell.js && node test/context.js && node test/integration.js && node test/parity.js && node test/automation.js && node test/native.js"
+    "test": "node test/cli-surface.js && node test/shell.js && node test/context.js && node test/integration.js && node test/parity.js && node test/automation.js && node test/native.js"
   },
   "keywords": [
     "arenacode",

package/src/automation/win-dll.js

@@ -285,6 +285,20 @@ function tool(kind, args = {}) {
 }
 
 /** The value inside {"ok":true,"result":…}, or {ok:false,error} unchanged. */
+/**
+ * The request windows-use expects for typing. The two forms are not interchangeable:
+ * with the coordinates of the field it is `type_tool` (`loc` is required, the DLL
+ * answers "loc: field required" otherwise), without them it is `type_focus_tool`,
+ * which writes into whatever holds the focus.
+ */
+function typeRequest(text, x = null, y = null) {
+  const value = String(text);
+  const located = Number.isFinite(x) && Number.isFinite(y);
+  return located
+    ? { tool: TOOLS.type, args: { loc: [Math.round(x), Math.round(y)], text: value } }
+    : { tool: TOOLS.type_focus, args: { text: value } };
+}
+
 function result(answer) {
   if (!answer || typeof answer !== 'object') return { ok: false, error: 'no answer' };
   if (answer.ok === false) return { ok: false, error: answer.error || 'windows-use error' };
@@ -400,12 +414,13 @@ const backend = {
   },
 
   typeText(text, x = null, y = null) {
-    if (x !== null && y !== null) {
-      const clicked = backend.click(x, y);
-      if (!clicked.ok) return clicked;
-    }
-    const r = result(tool('type', { text: String(text) }));
-    return r.ok ? { ok: true, chars: String(text).length, typed: String(text).length } : r;
+    // windows-use has two forms and they are not interchangeable: type_tool needs the
+    // coordinates of the field (loc), type_focus_tool writes into the focused element.
+    // Without loc the DLL answers "loc: field required".
+    const value = String(text);
+    const r = result(raw(typeRequest(value, x, y)));
+    if (!r.ok) return r;
+    return { ok: true, chars: value.length, typed: value.length };
   },
 
   pressKeys(combo) {
@@ -484,6 +499,7 @@ module.exports = {
   load,
   version,
   tool,
+  typeRequest,
   result,
   raw,
   backend,

package/src/cli.js

@@ -133,7 +133,7 @@ async function ensureAuth(ctx) {
 // commands
 // --------------------------------------------------------------------------- //
 
-async function cmdInit(flags, { tail = true } = {}) {
+async function firstRunSetup(flags, { tail = true } = {}) {
   banner(VERSION);
   const cfg = readConfig();
   write(c.gray(`  config file: ${configPath()}`));
@@ -179,105 +179,6 @@ async function cmdInit(flags, { tail = true } = {}) {
   return 0;
 }
 
-function cmdConfig(positional, flags) {
-  const [action = 'show', key, ...rest] = positional;
-  const cfg = readConfig();
-  if (action === 'path') {
-    write(configPath());
-    return 0;
-  }
-  if (action === 'show') {
-    const shown = { ...cfg, key: cfg.key ? `${cfg.key.slice(0, 8)}…` : '' };
-    write(JSON.stringify(shown, null, 2));
-    write(c.gray(`# ${configPath()}`));
-    return 0;
-  }
-  if (action === 'set') {
-    const name = key;
-    const val = rest.join(' ');
-    if (!name || val === '') {
-      write(`usage: ${SELF} config set <url|key|lang|mode|approval|pc_access|shell> <value>`);
-      return 2;
-    }
-    if (name === 'approval' && !['ask', 'proceed'].includes(String(val))) {
-      write(c.red('  ✗ approval must be ask or proceed'));
-      write(c.gray(`    ask      ${'Ask and Proceed'}: the client asks before commands, file changes and plans`));
-      write(c.gray(`    proceed  Proceed: the client does everything on its own`));
-      return 2;
-    }
-    const patch = {};
-    if (name === 'pc_access') patch.pc_access = !['false', '0', 'no', 'off'].includes(String(val).toLowerCase());
-    else if (name === 'url') patch.url = String(val).replace(/\/+$/, '');
-    else patch[name] = val;
-    const file = patchConfig(patch);
-    write(`  ${c.green('✓')} ${name} saved ${c.gray(file)}`);
-    if (name === 'approval' && patch.approval === 'proceed') {
-      const d = dangerText(cfg.lang);
-      write('');
-      write(`  ${c.bold(c.red('⚠ ' + d.title))}`);
-      write(indentLines(c.yellow(d.body), '  '));
-    }
-    return 0;
-  }
-  if (action === 'clear') {
-    try {
-      fs.rmSync(configPath());
-    } catch {
-      /* ignore */
-    }
-    write(`  ${c.green('✓')} config removed`);
-    return 0;
-  }
-  write(`usage: ${SELF} config [show|path|set <key> <value>|clear]`);
-  return 2;
-}
-
-async function cmdPing(flags) {
-  const ctx = context(flags);
-  if (!requireUrl(ctx)) return 1;
-  const health = await ctx.bridge.health();
-  if (health.status !== 200) {
-    write(c.red(`  ✗ bridge unreachable: ${(health.json && health.json.error) || health.status}`));
-    return 1;
-  }
-  const h = health.json;
-  if (ctx.json) {
-    write(JSON.stringify(h, null, 2));
-    return 0;
-  }
-  write('');
-  write(`  ${c.green('●')} bridge ${c.bold('v' + h.version)} ${c.gray(`· executor=${h.executor_mode} · terminal=${h.terminal ? 'on' : 'off'}`)}`);
-  write(`  ${c.gray('url')}      ${h.public_url || c.gray('(no tunnel)')}`);
-  write(`  ${c.gray('tasks')}    ${h.tasks.claimable} claimable · ${h.tasks.pending} pending · ${h.tasks.done} done`);
-  const auth = await ctx.bridge.authCheck();
-  write(`  ${auth.status === 200 ? c.green('✓') : c.red('✗')} auth ${auth.status === 200 ? 'ok' : (auth.json && auth.json.error) || auth.status}`);
-  return auth.status === 200 ? 0 : 1;
-}
-
-async function cmdDoctor(flags) {
-  const ctx = context(flags);
-  write('');
-  write(`  ${c.bold('arenacode doctor')}`);
-  const line = (ok, label, detail = '') => write(`  ${ok ? c.green('✓') : c.red('✗')} ${label.padEnd(18)} ${c.gray(detail)}`);
-  line(Number(process.versions.node.split('.')[0]) >= 18, 'node', process.version);
-  line(true, 'platform', `${process.platform} ${os.release()} ${os.arch()}`);
-  line(Boolean(ctx.url), 'bridge url', ctx.url || 'not configured');
-  line(true, 'config', configPath());
-  line(/^[A-Za-z0-9-]{8,128}$/.test(deviceId()), 'device id', deviceId().slice(0, 12) + '…');
-  line(fs.existsSync(ctx.folder), 'open folder', ctx.folder);
-  line(Boolean(require('./meta').which('git')), 'git', require('./meta').which('git') ? 'available' : 'missing');
-  if (ctx.url) {
-    const health = await ctx.bridge.health();
-    line(health.status === 200, 'bridge', health.status === 200 ? `v${health.json.version} ${health.json.public_url || ''}` : (health.json && health.json.error) || 'unreachable');
-    if (health.status === 200) {
-      const auth = await ctx.bridge.authCheck();
-      line(auth.status === 200, 'api key', auth.status === 200 ? 'accepted' : (auth.json && auth.json.error) || String(auth.status));
-    }
-  }
-  write('');
-  return 0;
-}
-
 function agentPrompt() {
   try {
     return fs.readFileSync(AGENT_PROMPT_FILE, 'utf8');
@@ -383,12 +284,17 @@ async function runInstruction(ctx, text, { attachments = [] } = {}) {
   }
 }
 
-async function cmdAsk(positional, flags) {
+/**
+ * Runs one instruction and streams the timeline. Internal on purpose: the client no
+ * longer exposes subcommands, `arenacode` opens the TUI and this is the code path the
+ * TUI itself uses (and the integration test).
+ */
+async function runOnce(instruction, flags = {}) {
   const ctx = context(flags);
   if (!requireUrl(ctx)) return 1;
-  const text = positional.join(' ').trim();
+  const text = String(Array.isArray(instruction) ? instruction.join(' ') : instruction || '').trim();
   if (!text) {
-    write('usage: arenacode ask "your instruction"');
+    write(c.red('  no instruction'));
     return 2;
   }
   if (!(await ensureAuth(ctx))) return 1;
@@ -414,7 +320,7 @@ async function cmdUi(flags) {
     write('');
     write(`  ${c.bold('first run')} ${c.gray('· bridge URL and API key (Enter keeps the value in brackets)')}`);
     write('');
-    await cmdInit(flags, { tail: false });
+    await firstRunSetup(flags, { tail: false });
     write('');
     ctx = context(flags);
     if (!ctx.url) return 1;   // setup was abandoned: nothing to open
@@ -435,354 +341,17 @@ async function cmdUi(flags) {
   return 0;
 }
 
-async function cmdChat(flags) {
-  const ctx = context(flags);
-  if (!requireUrl(ctx)) return 1;
-  if (!(await ensureAuth(ctx))) return 1;
-  banner(VERSION);
-  write(`  ${c.gray('bridge')} ${ctx.url}   ${c.gray('folder')} ${ctx.folder}`);
-  write(`  ${c.gray('type a request · /help for commands · Ctrl+D to quit')}`);
-  write('');
-
-  const readline = require('node:readline');
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: process.stdin.isTTY });
-  const prompt = () => {
-    rl.setPrompt(c.cyan('  › '));
-    rl.prompt();
-  };
-
-  return new Promise((resolve) => {
-    prompt();
-    rl.on('line', async (line) => {
-      const input = line.trim();
-      if (!input) {
-        prompt();
-        return;
-      }
-      rl.pause();
-      try {
-        if (input === '/quit' || input === '/exit') {
-          rl.close();
-          return;
-        }
-        if (input === '/help') {
-          write(`  ${c.gray('/files [path]')}  list the bridge workspace     ${c.gray('/cat <path>')}  preview a file`);
-          write(`  ${c.gray('/mode agent|plan')}  switch mode          ${c.gray('/lang it|en|es')}  interface language`);
-          write(`  ${c.gray('/folder <dir>')}   change the open folder      ${c.gray('/ping')}  bridge status`);
-          write(`  ${c.gray('/tasks')}  queue           ${c.gray('/stop <id>')}  cancel a turn   ${c.gray('/quit')}`);
-          write('');
-        } else if (input === '/ping') {
-          await cmdPing({ ...flags });
-        } else if (input === '/tasks') {
-          await cmdTasks([], flags);
-        } else if (input.startsWith('/files')) {
-          await cmdFiles(input.split(/\s+/).slice(1), flags);
-        } else if (input.startsWith('/cat ')) {
-          await cmdCat([input.slice(5).trim()], flags);
-        } else if (input.startsWith('/mode ')) {
-          const mode = input.slice(6).trim() === 'plan' ? 'plan' : 'agent';
-          patchConfig({ mode });
-          ctx.mode = mode;
-          write(`  ${c.green('✓')} mode ${mode}`);
-        } else if (input.startsWith('/lang ')) {
-          const lang = input.slice(6).trim().slice(0, 2);
-          patchConfig({ lang });
-          ctx.lang = lang;
-          write(`  ${c.green('✓')} lang ${lang}`);
-        } else if (input.startsWith('/folder ')) {
-          const folder = path.resolve(input.slice(8).trim().replace(/^"|"$/g, ''));
-          patchConfig({ folder });
-          ctx.folder = folder;
-          write(`  ${c.green('✓')} folder ${folder}`);
-        } else if (input.startsWith('/stop')) {
-          const id = input.split(/\s+/)[1];
-          if (id) await cmdStop([id], flags);
-          else write(c.gray('  usage: /stop <task-id>'));
-        } else {
-          await runInstruction(ctx, input);
-        }
-      } catch (e) {
-        write(c.red(`  ✗ ${e.message}`));
-      }
-      write('');
-      rl.resume();
-      prompt();
-    });
-    rl.on('close', () => {
-      write('');
-      resolve(0);
-    });
-  });
-}
-
-async function cmdTasks(positional, flags) {
-  const ctx = context(flags);
-  if (!requireUrl(ctx)) return 1;
-  const state = positional[0] || flags.state || 'all';
-  const res = await ctx.bridge.listTasks(state);
-  if (res.status !== 200) {
-    write(c.red(`  ✗ ${(res.json && res.json.error) || res.status}`));
-    return 1;
-  }
-  if (ctx.json) {
-    write(JSON.stringify(res.json, null, 2));
-    return 0;
-  }
-  const tasks = res.json.tasks || [];
-  if (!tasks.length) {
-    write(c.gray('  (no tasks)'));
-    return 0;
-  }
-  for (const task of tasks) {
-    const when = new Date(task.created_at * 1000).toLocaleString();
-    const stateTone = task.state === 'done' ? 'green' : task.state === 'error' ? 'red' : task.state === 'cancelled' ? 'yellow' : 'cyan';
-    write(`  ${c[stateTone](task.state.padEnd(9))} ${c.gray(when)}  ${c.bold(task.id)}  ${c.gray(truncate(String(task.instruction).split('\n').slice(-1)[0], 60))}`);
-  }
-  return 0;
-}
-
-async function cmdStatus(positional, flags) {
-  const ctx = context(flags);
-  if (!requireUrl(ctx)) return 1;
-  let id = positional[0];
-  if (!id) {
-    const latest = await latestTaskId(ctx);
-    if (latest.error) {
-      write(c.red(`  ✗ ${latest.error}`));
-      return 1;
-    }
-    id = latest.id;
-    if (!id) {
-      write(c.gray('  no tasks on the bridge yet — run: arenacode ask "…"'));
-      return 1;
-    }
-    write(c.gray(`  latest task: ${id}`));
-  }
-  const res = await ctx.bridge.getTask(id);
-  if (res.status !== 200) {
-    write(c.red(`  ✗ ${(res.json && res.json.error) || res.status}`));
-    return 1;
-  }
-  if (ctx.json) {
-    write(JSON.stringify(res.json, null, 2));
-    return 0;
-  }
-  const t = res.json;
-  write('');
-  write(`  ${c.bold(t.id)}  ${c.cyan(t.state)}  ${c.gray(new Date(t.created_at * 1000).toLocaleString())}`);
-  if (t.claimant) write(`  ${c.gray('claimant')} ${t.claimant}`);
-  if (t.error) write(`  ${c.red('error')}    ${t.error}`);
-  if (t.output) {
-    write('');
-    write(indentLines(String(t.output).trim(), '  │ '));
-  }
-  return 0;
-}
-
-async function cmdEvents(positional, flags) {
-  const ctx = context(flags);
-  if (!requireUrl(ctx)) return 1;
-  let id = positional[0];
-  if (!id) {
-    const latest = await latestTaskId(ctx);
-    if (latest.error) {
-      write(c.red(`  ✗ ${latest.error}`));
-      return 1;
-    }
-    id = latest.id;
-    if (!id) {
-      write(c.gray('  no tasks on the bridge yet — run: arenacode ask "…"'));
-      return 1;
-    }
-    write(c.gray(`  latest task: ${id}`));
-  }
-  const res = await ctx.bridge.getTask(id);
-  if (res.status !== 200) {
-    write(c.red(`  ✗ ${(res.json && res.json.error) || res.status}`));
-    return 1;
-  }
-  const { Timeline } = require('./turn');
-  const timeline = new Timeline({ folder: ctx.folder, lang: ctx.lang });
-  for (const ev of res.json.events || []) timeline.render(ev);
-  timeline.newlineIfText();
-  write(c.gray(`  state: ${res.json.state}`));
-  return 0;
-}
-
-async function cmdStop(positional, flags) {
-  const ctx = context(flags);
-  if (!requireUrl(ctx)) return 1;
-  let id = positional[0];
-  if (!id) {
-    const res = await ctx.bridge.listTasks('all');
-    const live = (res.json.tasks || []).filter((t) => !['done', 'error', 'cancelled'].includes(t.state)).pop();
-    id = live && live.id;
-  }
-  if (!id) {
-    write(c.gray('  nothing to stop'));
-    return 0;
-  }
-  const res = await ctx.bridge.cancel(id);
-  if (res.status !== 200) {
-    write(c.red(`  ✗ ${(res.json && res.json.error) || res.status}`));
-    return 1;
-  }
-  write(`  ${c.yellow('■')} stopped ${id}`);
-  return 0;
-}
-
-async function cmdFiles(positional, flags) {
-  const ctx = context(flags);
-  if (!requireUrl(ctx)) return 1;
-  const rel = positional[0] || '';
-  const res = await ctx.bridge.fs(rel);
-  if (res.status !== 200) {
-    write(c.red(`  ✗ ${(res.json && res.json.error) || res.status}`));
-    return 1;
-  }
-  if (ctx.json) {
-    write(JSON.stringify(res.json, null, 2));
-    return 0;
-  }
-  write(c.gray(`  ${res.json.root}/${res.json.path}`));
-  for (const entry of res.json.entries) {
-    const size = entry.type === 'dir' ? '<DIR>' : String(entry.size);
-    write(`  ${c.gray(size.padStart(9))}  ${entry.type === 'dir' ? c.cyan(entry.name + '/') : entry.name}`);
-  }
-  return 0;
-}
-
-async function cmdCat(positional, flags) {
-  const ctx = context(flags);
-  if (!requireUrl(ctx)) return 1;
-  const rel = positional[0];
-  if (!rel) {
-    write('usage: arenacode cat <path>');
-    return 2;
-  }
-  const res = await ctx.bridge.file(rel);
-  if (res.status !== 200) {
-    write(c.red(`  ✗ ${(res.json && res.json.error) || res.status}`));
-    return 1;
-  }
-  if (res.json.binary) {
-    write(c.gray(`  binary file (${res.json.size} B)`));
-    return 0;
-  }
-  write(res.json.text);
-  return 0;
-}
-
-async function cmdAttach(positional, flags) {
-  const ctx = context(flags);
-  if (!requireUrl(ctx)) return 1;
-  if (!positional.length) {
-    write('usage: arenacode attach <file> [more files]');
-    return 2;
-  }
-  for (const file of positional) {
-    const abs = path.resolve(file);
-    if (!fs.existsSync(abs)) {
-      write(c.yellow(`  ! missing: ${file}`));
-      continue;
-    }
-    const name = `attachments/${Date.now()}-${path.basename(abs)}`;
-    const res = await ctx.bridge.upload(name, fs.readFileSync(abs));
-    if (res.status !== 200) {
-      write(c.red(`  ✗ ${(res.json && res.json.error) || res.status}`));
-      return 1;
-    }
-    write(`  ${c.green('↑')} ${res.json.path} ${c.gray(`(${res.json.size} B)`)}`);
-  }
-  return 0;
-}
-
 /** Handshake task the desktop client sends to check the bridge and vision. */
-async function cmdHandshake(flags) {
-  const ctx = context(flags);
-  if (!requireUrl(ctx)) return 1;
-  if (!(await ensureAuth(ctx))) return 1;
-  const instruction =
-    '[ArenaCode handshake] Vision check. The bridge creates the image, not you: do not write, copy or edit any PNG ' +
-    'or other image. Run `python3 agentctl.py vision-png <task id>`, open the PNG it prints and look at it, then run ' +
-    '`python3 agentctl.py --has-vision-enabled:true <task id>` if you can see and describe it, or ' +
-    '`--has-vision-enabled:false` if you cannot. Reply with one short sentence describing what you see, then go back ' +
-    'to listening.';
-  write('');
-  write(`  ${c.bold('handshake')} ${c.gray('· vision check')}`);
-  return runInstruction(ctx, instruction);
-}
-
 
 /** Short, command-specific usage: a missing argument must not send you to the full help page. */
-const USAGE = {
-  init:      [['init', 'configure bridge URL + API key, then test the connection']],
-  config:    [['config [show|path]', 'read the saved configuration'],
-              ['config set <key> <value>', 'url · key · lang · mode · pc_access · shell']],
-  ping:      [['ping', 'bridge status and API key check']],
-  doctor:    [['doctor', 'local checks: node, platform, folder, git, bridge']],
-  ask:       [['ask "instruction"', 'run one task and stream the timeline']],
-  ui:        [['ui', 'full-screen TUI']],
-  chat:      [['chat', 'plain line-by-line session']],
-  tasks:     [['tasks [state]', 'task queue (all · claimable · pending · done)']],
-  status:    [['status [task-id]', 'state of a task (default: the latest one)']],
-  events:    [['events [task-id]', 'timeline of a task (default: the latest one)']],
-  stop:      [['stop [task-id]', 'cancel the running turn (default: the live one)']],
-  files:     [['files [path]', 'listing of the folder on the PC']],
-  cat:       [['cat <path>', 'preview a file of the folder on the PC']],
-  attach:    [['attach <file…>', 'upload files to the bridge workspace']],
-  handshake: [['handshake', 'vision/handshake check task']],
-};
-
-function cmdUsage(name) {
-  const rows = USAGE[name] || [];
-  if (!rows.length) return help();
-  banner(VERSION);
-  for (const [u, why] of rows) {
-    write(`  ${c.bold('usage')}  ${SELF} ${u}`);
-    write(`         ${c.gray(why)}`);
-  }
-  write('');
-  write(`  ${c.gray(`every option: ${SELF} --help`)}`);
-  return 0;
-}
-
-/** `status` / `events` with no argument means "the task I just ran". */
-async function latestTaskId(ctx) {
-  const res = await ctx.bridge.listTasks('all');
-  if (res.status !== 200) return { error: (res.json && (res.json.error || res.json.hint)) || `HTTP ${res.status}` };
-  const tasks = (res.json && res.json.tasks) || [];
-  return { id: tasks.length ? tasks[tasks.length - 1].id : null };
-}
-
 function help() {
-  banner(VERSION);
-  write(`  ${c.bold('usage')}  arenacode <command> [options]`);
-  if (SELF !== 'arenacode') {
-    write(`         ${c.gray('you are running it through npx — every command can be prefixed the same way,')}`);
-    write(`         ${c.gray(`or install it once: ${INSTALL_HINT}`)}`);
-  }
   write('');
-  write(`  ${c.cyan('setup')}`);
-  write(`    init                       configure URL + API key, test the connection`);
-  write(`    config [show|set|path]     read or change the saved configuration`);
-  write(`    ping                       bridge status and API key check`);
-  write(`    doctor                     local checks (node, git, folder, bridge)`);
+  write(`  ${c.cyan('ArenaCode CLI')} ${c.gray(`v${VERSION}`)} ${c.gray('· terminal client for arena-bridge')}`);
   write('');
-  write(`  ${c.cyan('chat')}`);
-  write(`    ask "instruction"          run one task and stream the timeline`);
-  write(`    ui                         full-screen TUI (default on a terminal)`);
-  write(`    chat                       plain line-by-line session`);
-  write(`    stop [task-id]             cancel the running turn (Stop)`);
-  write(`    handshake                  vision/handshake check task`);
+  write(`  usage  ${c.bold('arenacode')} [options]`);
   write('');
-  write(`  ${c.cyan('inspect')}`);
-  write(`    tasks [state]              task queue on the bridge`);
-  write(`    status <task-id>           state and result of a task`);
-  write(`    events <task-id>           timeline of a task`);
-  write(`    files [path]               bridge workspace listing`);
-  write(`    cat <path>                 preview a file in the bridge workspace`);
-  write(`    attach <file…>             upload files to the bridge workspace`);
+  write(`  ${c.cyan('the client')}`);
+  write(`    ${c.bold('arenacode')}                 open the interface: timeline, input box, cards, settings`);
   write('');
   write(`  ${c.cyan('options')}`);
   write(`    --folder <dir>             open folder (the project the agent works on)`);
@@ -795,7 +364,8 @@ function help() {
     --proceed                  Proceed: approve the plan and run everything without asking
     --confirm-writes           ask before write/replace/rm/mv on your folder`);
   write(`    --attach a,b               upload files with the task`);
-  write(`    --json                     raw JSON output where available`);
+  write(`    -h, --help                 this text`);
+  write(`    -v, --version              the version`);
   write('');
   write(c.gray('  docs: https://github.com/  ·  bridge: arena-bridge 2.5.2'));
   write('');
@@ -806,70 +376,25 @@ function help() {
 
 async function main(argv) {
   const { flags, positional } = parseArgs(argv);
-  // No default here: a bare `arenacode` must be distinguishable from `arenacode chat`, because only
-  // the bare form opens the TUI. Defaulting to 'chat' sent every plain invocation to the line CLI.
-  const [first = undefined, ...rest] = positional;
-  const command = first;
+  const command = positional[0];
 
   if (flags.version || command === 'version') {
     write(VERSION);
     return 0;
   }
-  if (flags.help) return command && USAGE[command] ? cmdUsage(command) : help();
-  if (command === 'help') return help();
-
-  switch (command) {
-    case 'init':
-      return cmdInit(flags);
-    case 'config':
-      return cmdConfig(rest, flags);
-    case 'ping':
-      return cmdPing(flags);
-    case 'doctor':
-      return cmdDoctor(flags);
-    case 'ask':
-      return cmdAsk(rest, flags);
-    case 'ui':
-    case 'tui':
-      return cmdUi(flags);
-    case 'chat':
-      return cmdChat(flags);
-    case 'tasks':
-      return cmdTasks(rest, flags);
-    case 'status':
-      return cmdStatus(rest, flags);
-    case 'events':
-      return cmdEvents(rest, flags);
-    case 'stop':
-      return cmdStop(rest, flags);
-    case 'files':
-      return cmdFiles(rest, flags);
-    case 'cat':
-      return cmdCat(rest, flags);
-    case 'attach':
-      return cmdAttach(rest, flags);
-    case 'handshake':
-      return cmdHandshake(flags);
-    default:
-      if (command === undefined) {
-        // bare invocation: the interface, when there is a terminal to draw it on
-        if (process.stdout.isTTY && process.stdin.isTTY) return cmdUi(flags);
-        help();
-        return 0;
-      }
-      if (command.startsWith('-')) {
-        // `arenacode "instruction"` convenience form
-        return cmdAsk(positional, flags);
-      }
-      {
-        // a typo used to dump the whole help with no clue about what went wrong
-        const known = ['init','config','ping','doctor','ask','ui','chat','tasks','status','events','stop','files','cat','attach','handshake','help','version'];
-        const near = known.find((k) => k.startsWith(command.slice(0, 3)) || command.startsWith(k.slice(0, 3)));
-        write(c.red(`  unknown command: ${command}`) + (near ? c.gray(`  · did you mean ${c.bold(near)}?`) : ''));
-      }
-      help();
-      return 2;
+  if (flags.help || command === 'help') return help();
+
+  if (command !== undefined && !command.startsWith('-')) {
+    // The subcommands are gone: one entry point, the interface. Saying it out loud is
+    // better than opening the TUI and letting the user wonder why nothing ran.
+    write(c.red(`  command removed: ${command}`) + c.gray('  · the client opens the interface: arenacode'));
+    return 2;
   }
+
+  if (process.stdout.isTTY && process.stdin.isTTY) return cmdUi(flags);
+  if (!requireUrl(context(flags))) return 1;
+  write(c.red('  the interface needs an interactive terminal.'));
+  return 1;
 }
 
-module.exports = { main, parseArgs, MODE_LINES, createTask };
+module.exports = { main, runOnce, parseArgs, firstRunSetup, MODE_LINES, createTask };

package/src/config.js

@@ -6,7 +6,9 @@ const os = require('node:os');
 const path = require('node:path');
 const { execFileSync } = require('node:child_process');
 
-const VERSION = '2.5.2';
+// The version is the package's: a hardcoded copy went stale and the client introduced
+// itself to the bridge as "ArenaCode 2.5.2" while the package was 2.11.2.
+const VERSION = require('../package.json').version;
 const CLIENT_NAME = `ArenaCode ${VERSION}`;
 
 /**

package/src/local.js

@@ -58,7 +58,7 @@ function relativize(root, abs) {
 // --------------------------------------------------------------------------- //
 
 // Every shell the client can drive. The bridge may ask for one by name (`shell` in the
-// local-exec request), the user can pin one (`arenacode config set shell zsh`, `/shell`),
+// local-exec request), the user can pin one (`/shell` in the interface),
 // and otherwise the client takes the user's login shell, like a terminal would.
 const UNIX_SHELLS = {
   sh: '/bin/sh',
@@ -194,7 +194,7 @@ async function handleLocalExec(bridge, taskId, request, opts) {
   const lang = opts.lang;
   const dir = reqCwd ? resolveInRoot(opts.folder, reqCwd) : opts.folder;
   // the bridge names the shell it wrote the command for; otherwise the user's choice
-  // from `arenacode config set shell …` / `/shell`, otherwise the login shell
+  // from `/shell` (and `--shell`), otherwise the login shell
   const chosenShell = shell || opts.shell || detectShell();
 
   write('');

package/src/tui/app.js

@@ -15,7 +15,7 @@ const { getTheme, themeNames } = require('./theme');
 const { Bridge } = require('../bridge');
 const { buildMeta, readProjectContext } = require('../meta');
 const { runShell, runFsOp, resolveInRoot, detectShell, availableShells, shellCommand } = require('../local');
-const { readConfig, patchConfig, deviceId, resolveUrl, resolveKey, openFolder, VERSION } = require('../config');
+const { readConfig, patchConfig, deviceId, resolveUrl, resolveKey, openFolder, configPath, VERSION } = require('../config');
 const { ensureContextFile, touchSession } = require('../context');
 
 const { MODE_LINES, modeLabel, nextMode, normaliseMode } = require('../modes');
@@ -485,6 +485,7 @@ class App {
         if (h) this.push({ kind: 'system', text: `bridge v${h.version} · ${h.executor_mode} · claimable ${h.tasks.claimable}` });
         else this.toast('bridge unreachable', 'error');
       } },
+      { title: 'Settings (bridge URL and API key)', hint: '/settings', run: () => this.openSettings() },
       { title: 'Help', hint: 'f1', run: () => this.openHelp() },
       { title: 'Quit', hint: 'ctrl+x q', run: () => this.quit() },
     ].map((cmd) => ({ ...cmd, slash: '/' + cmd.title.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/-+$/, ''), group: 'Commands' }));
@@ -505,6 +506,7 @@ class App {
       { slash: '/theme', title: 'Cycle the colour theme', hint: 'ctrl+x t', group: 'Session', run: by('Theme') },
       { slash: '/shell', title: 'Show or change the shell commands run in', hint: '', group: 'Session', run: () => this.pickShell() },
       { slash: '/status', title: 'Ping the bridge', hint: '', group: 'Session', run: by('Bridge status') },
+      { slash: '/settings', title: 'Bridge URL and API key', hint: '', group: 'Session', run: () => this.openSettings() },
       { slash: '/help', title: 'Every keybinding', hint: 'f1', group: 'Session', run: () => this.openHelp() },
       { slash: '/quit', title: 'Leave arenacode', hint: 'ctrl+x q', group: 'Session', run: () => this.quit() },
     ];
@@ -549,6 +551,56 @@ class App {
     this.toast(`approval: ${next === 'proceed' ? 'Proceed' : 'Ask and Proceed'}`, next === 'proceed' ? 'warn' : 'ok');
   }
 
+  /**
+   * `/settings` (and the palette): bridge URL and API key. The client has no subcommands
+   * any more, so this is the only place they can be changed after the first run.
+   */
+  async openSettings() {
+    this.push({ kind: 'system', text: `settings: ${configPath()}` });
+
+    const url = String(await this.prompt(`bridge URL [${this.url || 'not set'}]`)).trim();
+    if (url && url !== this.url) {
+      this.url = url;
+      try {
+        patchConfig({ url });
+      } catch {
+        /* read-only HOME: keep it in memory */
+      }
+    }
+    if (!this.url) {
+      this.toast('settings: the bridge URL is required', 'warn');
+      return;
+    }
+
+    const masked = this.key ? `${String(this.key).slice(0, 8)}…` : 'not set';
+    const key = String(await this.prompt(`API key [${masked}]`)).trim();
+    if (key) {
+      this.key = key;
+      try {
+        patchConfig({ key });
+      } catch {
+        /* read-only HOME: keep it in memory */
+      }
+    }
+
+    this.bridge = new Bridge(this.url, this.key, deviceId(readConfig()));
+    await this.refreshHealth();
+    const health = this.state.health;
+    if (!health) {
+      this.push({ kind: 'system', text: `settings: ${this.url} unreachable — check the URL and the tunnel` });
+      this.toast('settings saved · bridge unreachable', 'error');
+      return;
+    }
+    const auth = await this.bridge.authCheck();
+    const json = auth.json || {};
+    const accepted = auth.status === 200;
+    this.push({
+      kind: 'system',
+      text: `settings: bridge v${health.version} · ${health.executor_mode} · key ${accepted ? 'accepted' : `rejected (${json.error || auth.status})`}`,
+    });
+    this.toast(accepted ? 'settings saved · key accepted' : 'settings saved · key rejected', accepted ? 'ok' : 'warn');
+  }
+
   /** `/shell` (and the double-click on a card's shell line): pick from the shells here. */
   async pickShell(name = '') {
     const shells = availableShells();
@@ -674,7 +726,7 @@ class App {
       return;
     }
     if (!this.url) {
-      this.toast('no bridge URL: run arenacode init', 'error');
+      this.toast('no bridge URL: /settings', 'error');
       return;
     }
     const tmp = path.join(require('os').tmpdir(), `arenacode-clip-${stamp()}-${process.pid}.png`);
@@ -710,7 +762,7 @@ class App {
       return;
     }
     if (!this.url) {
-      this.toast('no bridge URL: run arenacode init', 'error');
+      this.toast('no bridge URL: /settings', 'error');
       return;
     }
 
@@ -1537,6 +1589,7 @@ function HELP_ROWS() {
     ['Session', 'ctrl+x l', 'task queue'],
     ['Session', 'ctrl+x a', 'Ask and Proceed / Proceed'],
     ['Session', 'ctrl+x t', 'switch theme'],
+    ['Session', '/settings', 'bridge URL and API key'],
     ['Session', 'ctrl+x d', 'toggle tool output'],
     ['Session', 'pgup / pgdn', 'scroll'],
     ['Session', 'ctrl+l', 'clear the timeline'],