@double_geste/agent-standup 0.0.0-stage → 1.22.0

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Arthur
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,18 @@
-# Temporary Holding Version
+# Agent Standup (command line)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Your Claude Code sessions as a live team call, without any editor. Free, MIT, and it never calls Claude: it only reads the session files Claude Code already writes.
+
+```bash
+npx @double_geste/agent-standup            # then open http://localhost:4747   (add --open to open it for you)
+npx @double_geste/agent-standup status     # ⚙ 3 working · ✋ 1 needs you
+```
+
+Install once for status bars (faster than npx): `npm i -g @double_geste/agent-standup`
+
+- **Claude Code status line**: in `~/.claude/settings.json` add `{ "statusLine": { "type": "command", "command": "agent-standup statusline" } }`
+- **tmux**: `set -g status-right '#(agent-standup status --here)'`
+- **Anything else**: `agent-standup status --json`
+
+Full documentation, the VS Code extension, the desktop app and the demo: https://atoll92.github.io/agent-standup/ · https://github.com/Atoll92/agent-standup.git
+
+Unofficial: not affiliated with Anthropic.

package/bin/agent-standup.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+// Agent Standup from a terminal: the live call in your browser, and one-line status for status bars (Claude Code, tmux, Neovim…).
+//   agent-standup [serve] [--port 4747] [--open]   start the local server and (optionally) open the page
+//   agent-standup status [--here] [--json]          counts of working / needs you / your turn
+//   agent-standup statusline                        same, one short line; reads Claude Code's statusLine JSON on stdin
+// Everything reads the local session files Claude Code already writes. Nothing is sent anywhere.
+const path = require('path'), { spawn } = require('child_process');
+const pkg = require('../package.json');
+const argv = process.argv.slice(2), flags = {}, rest = [];
+for (let i = 0; i < argv.length; i++) {
+  const a = argv[i], val = () => argv[++i];
+  if (a === '--port') flags.port = val(); else if (a === '--projects') flags.projects = val(); else if (a === '--characters') flags.characters = val(); else if (a === '--config-dir') flags.config = val();
+  else if (a === '--open') flags.open = true; else if (a === '--here') flags.here = true; else if (a === '--json') flags.json = true; else if (a === '--titles') flags.titles = true;
+  else if (a === '-h' || a === '--help') flags.help = true; else if (a === '-v' || a === '--version') flags.version = true; else rest.push(a);
+}
+const cmd = rest[0] || 'serve';
+const HELP = `Agent Standup ${pkg.version} — your Claude Code agents as a live video call
+
+Usage
+  agent-standup [serve] [--port 4747] [--open]   start the local server (http://localhost:4747)
+  agent-standup status [--here] [--json]          what is going on right now (--here: only the current folder)
+  agent-standup statusline                        one short line for a status bar (reads Claude Code's JSON on stdin)
+
+Options
+  --port N          port of the local server (default 4747)
+  --open            open the page in your browser
+  --projects DIR    where the session files are (default ~/.claude/projects, or $CLAUDE_CONFIG_DIR/projects)
+  --characters DIR  folder with your own pixel-art characters (default ~/.agent-standup/characters)
+  --here            status: only sessions of the current folder
+  --json            status: machine-readable output (add --titles to include session titles)
+`;
+if (flags.help || cmd === 'help') { process.stdout.write(HELP); process.exit(0); }
+if (flags.version || cmd === 'version') { console.log(pkg.version); process.exit(0); }
+if (flags.projects) process.env.AGENT_STANDUP_PROJECTS = path.resolve(flags.projects);
+if (flags.config) process.env.CLAUDE_CONFIG_DIR = path.resolve(flags.config);
+if (flags.characters) process.env.AGENT_STANDUP_CHARACTERS = path.resolve(flags.characters);
+if (flags.port) process.env.PORT = String(parseInt(flags.port, 10) || 4747);
+const server = require('../server.js');
+const projKey = (dir) => String(dir || '').replace(/[^a-zA-Z0-9]/g, '-');   // Claude Code's project folder naming
+
+function snapshot(dir) {
+  const now = Date.now(), all = server.boardRows(), rows = dir ? all.filter((r) => r.proj === projKey(dir)) : all;
+  const act = rows.filter((r) => r.state !== 'idle' || now - r.mtime < 15 * 60e3), n = (st) => act.filter((r) => r.state === st).length;
+  return { rows: act, needsYou: n('blocked'), working: n('working') + n('waiting'), yourTurn: n('turn'), idle: rows.length - act.length };
+}
+const line = (s, short) => { const p = []; if (s.needsYou) p.push(short ? `✋${s.needsYou}` : `✋ ${s.needsYou} needs you`); if (s.working) p.push(short ? `⚙${s.working}` : `⚙ ${s.working} working`); if (!s.needsYou && !s.working && s.yourTurn) p.push(short ? '✓' : '✓ your turn'); return p.join(short ? ' ' : ' · ') || (short ? '' : 'idle'); };
+
+if (cmd === 'status') {
+  const s = snapshot(flags.here ? process.cwd() : '');
+  if (flags.json) console.log(JSON.stringify({ needsYou: s.needsYou, working: s.working, yourTurn: s.yourTurn, idle: s.idle, sessions: s.rows.map((r) => ({ project: r.proj, id: r.id, state: r.state, tool: r.tool, ageMs: Math.round(r.ageMs), subAgentsActive: r.subActive, subAgents: r.subTotal, ...(flags.titles ? { title: r.title } : {}) })) }, null, 2));
+  else console.log(line(s, false));
+} else if (cmd === 'statusline') {
+  let raw = ''; const go = () => { let dir = ''; try { const j = JSON.parse(raw); dir = (j.workspace && j.workspace.current_dir) || j.cwd || ''; } catch {} console.log(line(snapshot(dir), true)); process.exit(0); };
+  if (process.stdin.isTTY) go(); else { process.stdin.setEncoding('utf8'); process.stdin.on('data', (d) => (raw += d)); process.stdin.on('end', go); setTimeout(go, 800); }
+} else if (cmd === 'serve') {
+  const port = +process.env.PORT || 4747, srv = server.start(port);
+  srv.on('error', (e) => { console.error(e.code === 'EADDRINUSE' ? `Port ${port} is already in use (Agent Standup may already be running, e.g. inside your editor). Try: agent-standup --port ${port + 1}` : String(e)); process.exit(1); });
+  srv.on('listening', () => { if (flags.open) { const url = `http://localhost:${port}/`, opener = process.platform === 'darwin' ? ['open', [url]] : process.platform === 'win32' ? ['cmd', ['/c', 'start', '', url]] : ['xdg-open', [url]]; try { spawn(opener[0], opener[1], { stdio: 'ignore', detached: true }).on('error', () => {}).unref(); } catch {} } });
+  process.on('SIGINT', () => { try { server.shutdown(); } catch {} process.exit(0); });
+} else { console.error(`Unknown command "${cmd}".\n\n${HELP}`); process.exit(2); }

package/demo.js

@@ -0,0 +1,95 @@
+// A made-up session used by the built-in demo (?demo=1, "Try the demo"): a fictional team fixes a slow login page
+// and flaky cart tests. No real project data. Same shape as what server.js builds from real transcripts.
+// `fr` holds the French version of spoken lines, so the demo needs no translation service.
+module.exports = function demoTimeline() {
+  const start = Date.now() - 8 * 60 * 1000;
+  let now = start, n = 0;
+  const events = [];
+  const agents = [
+    { id: 'main', role: 'Lead', type: 'main' },
+    { id: 'ada', name: 'Ada', role: 'Login profiling', roleFr: 'Profilage du login', type: 'general-purpose' },
+    { id: 'remy', name: 'Remy', role: 'Flaky cart tests', roleFr: 'Tests du panier instables', type: 'general-purpose' },
+    { id: 'iris', name: 'Iris', role: 'API error review', roleFr: 'Revue des erreurs API', type: 'general-purpose' },
+    { id: 'hugo', name: 'Lena', role: 'Retry logic check', roleFr: 'Vérif. de la logique de retry', type: 'general-purpose' },
+  ];
+  const cat = (lines) => lines.map((l, i) => String(i + 1).padStart(6) + '\t' + l).join('\n');
+  const ev = (gap, e) => { now += gap; events.push({ ts: now, ...e }); return now; };
+  const tok = (agent) => { const k = ++n; events.push({ ts: now - 5, agent, kind: 'usage', u: { i: 4 + (k % 7), o: 90 + ((k * 37) % 420), r: 16000 + k * 1100, w: k % 5 === 0 ? 2400 : 0 }, model: 'demo' }); };   // made-up numbers, same shape as real ones
+  const user = (text, fr) => ev(0, { agent: 'user', kind: 'user', text, fr });
+  const say = (agent, text, fr, gap = 2600) => { const t = ev(gap, { agent, kind: 'say', text, fr }); tok(agent); return t; };
+  const order = (from, to, title, text, fr, gap = 2200) => { const t = ev(gap, { agent: from, to, kind: 'order', title, text, fr }); tok(from); return t; };
+  const report = (agent, to, text, fr, gap = 2600) => ev(gap, { agent, to, kind: 'report', text, fr });
+  // one tool call + its result, `ms` later
+  const use = (agent, name, arg, d, out, { err = false, ms = 400, gap = 1500 } = {}) => {
+    const id = 'toolu_demo' + ++n, ts = ev(gap, { agent, kind: 'tools', tools: [{ id, name, arg, d }] }); tok(agent);
+    if (out != null) events.push({ ts: ts + ms, agent, kind: 'results', items: [{ id, err, out }] });
+    events[events.findIndex((e) => e.tools && e.tools[0].id === id)].tools[0].ts = ts;
+  };
+  const todo = (agent, items, gap = 1200) => use(agent, 'TodoWrite', 'update todos', { kind: 'todo', items: items.map(([c, s]) => ({ c, s })) }, null, { gap });
+
+  user('The login page is slow and the cart tests keep failing at random. Can you sort it out?',
+       'La page de connexion est lente et les tests du panier échouent au hasard. Tu peux régler ça ?');
+  say('main', "On it. I'll split the work: one agent profiles the login, one hunts the flaky cart tests, one reviews the API errors.",
+      "Je m'en occupe. Je répartis le travail : un agent profile le login, un autre traque les tests instables du panier, un troisième passe en revue les erreurs de l'API.", 3000);
+  todo('main', [['Profile the login flow', 'in_progress'], ['Fix the flaky cart tests', 'pending'], ['Review API error handling', 'pending'], ['Commit the changes', 'pending']]);
+  order('main', 'ada', 'Profile the login flow', "Find out why /login takes about 3 seconds. Read-only: don't edit anything. Report what you find, with file and line.",
+        "Trouve pourquoi /login prend environ 3 secondes. Lecture seule : ne modifie rien. Rapporte ce que tu trouves, avec fichier et ligne.");
+  order('main', 'remy', 'Fix the flaky cart tests', 'The cart tests fail about one run in three. Find the cause, fix it, then run the suite twice to be sure.',
+        'Les tests du panier échouent environ une fois sur trois. Trouve la cause, corrige, puis lance la suite deux fois pour être sûr.', 1200);
+  order('main', 'iris', 'Review API error handling', 'Review how src/api handles failures. List the unhandled errors and fix the safe ones. Ask Lena to check the retry logic.',
+        "Passe en revue la gestion des erreurs dans src/api. Liste celles qui ne sont pas gérées et corrige les plus sûres. Demande à Lena de vérifier la logique de retry.", 1200);
+
+  // --- parallel work -------------------------------------------------------------
+  use('ada', 'Read', 'src/pages/Login.jsx', { kind: 'read', file: 'src/pages/Login.jsx' }, cat([
+    "import { useEffect, useState } from 'react';", "import { useProfile } from '../context/ProfileProvider';", "import { fetchProfile } from '../api/profile';", "import { fetchNetworks } from '../api/networks';", '',
+    'export default function Login() {', '  const profile = useProfile();', '  const [networks, setNetworks] = useState(null);', '', '  useEffect(() => {', '    fetchProfile();            // <-- second call, the provider already fetched it',
+    '    fetchNetworks().then(setNetworks);', '  }, []);', '', '  if (!profile || !networks) return <Spinner />;', '', '  return (', '    <main className="login">', '      <LoginForm networks={networks} />', '    </main>', '  );', '}']), { ms: 220, gap: 2400 });
+  use('remy', 'Bash', 'npm test -- cart', { kind: 'cmd', text: 'npm test -- cart', note: 'Run the cart tests' },
+      ' FAIL  src/cart/cart.test.js\n  ● cart › updates the total after adding an item\n\n    expect(received).toBe(expected)\n\n    Expected: 42\n    Received: 0\n\n      18 |     addItem(item);\n    > 19 |     expect(total()).toBe(42);\n\nTests: 1 failed, 11 passed, 12 total', { err: true, ms: 2600, gap: 600 });
+  use('iris', 'Glob', 'src/api/**/*.js', { kind: 'glob', pattern: 'src/api/**/*.js' }, 'src/api/client.js\nsrc/api/errors.js\nsrc/api/networks.js\nsrc/api/profile.js\nsrc/api/checkout.js', { ms: 90, gap: 700 });
+  use('ada', 'Grep', 'fetchProfile', { kind: 'grep', pattern: 'fetchProfile', path: 'src' }, 'src/pages/Login.jsx:10:    fetchProfile();            // <-- second call\nsrc/context/ProfileProvider.jsx:18:    fetchProfile().then(setProfile);\nsrc/api/profile.js:4:export async function fetchProfile() {', { ms: 130, gap: 1700 });
+  use('remy', 'Read', 'src/cart/cart.test.js', { kind: 'read', file: 'src/cart/cart.test.js' }, cat([
+    "import { addItem, total, resetCart } from './cart';", "import { waitFor } from '../test-utils';", '', 'beforeEach(() => resetCart());', '', "test('starts empty', () => {", '  expect(total()).toBe(0);', '});', '',
+    "test('updates the total after adding an item', async () => {", '  const item = { id: 1, price: 42 };', '  addItem(item);', '  expect(total()).toBe(42);', '});']), { ms: 180, gap: 1800 });
+  use('iris', 'Read', 'src/api/errors.js', { kind: 'read', file: 'src/api/errors.js' }, cat([
+    "export async function handle(res) {", "  if (res.ok) return res.json();", "  // TODO: map status codes to friendly messages", "  throw new Error('request failed');", '}', '',
+    "export async function safe(fn) {", '  try { return await fn(); } catch (e) { /* ignored */ }', '}']), { ms: 160, gap: 1200 });
+  use('ada', 'Bash', 'npm run profile -- login', { kind: 'cmd', text: 'npm run profile -- login', note: 'Profile the login page' },
+      'login render: 3120 ms\n  ├─ fetchProfile   2410 ms   (called 2×)\n  ├─ fetchNetworks   380 ms\n  └─ paint           330 ms', { ms: 4200, gap: 1400 });
+  use('remy', 'Edit', 'src/cart/cart.test.js', { kind: 'edit', file: 'src/cart/cart.test.js', old: '  addItem(item);\n  expect(total()).toBe(42);', new: '  addItem(item);\n  await waitFor(() => expect(total()).toBe(42));' },
+      'The file src/cart/cart.test.js has been updated.', { ms: 120, gap: 1500 });
+  use('iris', 'Grep', 'catch', { kind: 'grep', pattern: 'catch', path: 'src/api' }, 'src/api/errors.js:8:  try { return await fn(); } catch (e) { /* ignored */ }\nsrc/api/checkout.js:22:  } catch (e) {\nsrc/api/profile.js:11:  } catch (e) {}', { ms: 110, gap: 1300 });
+  say('ada', "Found it: fetchProfile runs twice and blocks the first render. That's about 2.4 seconds.", "Trouvé : fetchProfile est appelé deux fois et bloque le premier affichage. Ça fait environ 2,4 secondes.", 1700);
+  use('remy', 'Bash', 'npm test -- cart', { kind: 'cmd', text: 'npm test -- cart', note: 'Run the cart tests again' },
+      ' PASS  src/cart/cart.test.js\n  ✓ starts empty (3 ms)\n  ✓ updates the total after adding an item (12 ms)\n\nTests: 12 passed, 12 total\nTime:  2.1 s', { ms: 2300, gap: 1500 });
+  order('iris', 'hugo', 'Retry logic check', 'Check the retry logic in src/api/client.js: any infinite retry, or no backoff?', 'Vérifie la logique de retry dans src/api/client.js : y a-t-il un retry infini, ou pas de backoff ?', 1600);
+  report('ada', 'main', 'Login is slow because fetchProfile runs twice (Login.jsx:10 and ProfileProvider.jsx:18) and blocks rendering. Fix: fetch once, in the provider. Expected: 3.1 s down to under 1 s.',
+         "Le login est lent car fetchProfile est appelé deux fois (Login.jsx:10 et ProfileProvider.jsx:18) et bloque l'affichage. Correctif : un seul appel, dans le provider. Attendu : de 3,1 s à moins d'une seconde.", 1400);
+  use('hugo', 'Read', 'src/api/client.js', { kind: 'read', file: 'src/api/client.js' }, cat([
+    "const MAX = 5;", '', 'export async function request(url, opts, attempt = 0) {', '  try {', '    return await fetch(url, opts);', '  } catch (e) {', '    if (attempt >= MAX) throw e;', '    return request(url, opts, attempt + 1);   // no delay', '  }', '}']), { ms: 140, gap: 1000 });
+  say('remy', "The test didn't wait for the async total. Fixed, and green twice in a row.", "Le test n'attendait pas le total asynchrone. Corrigé, et vert deux fois de suite.", 1600);
+  report('remy', 'main', 'Cause: the cart test read the total before the async update finished. Added waitFor. Two consecutive runs pass (12/12).', "Cause : le test lisait le total avant la fin de la mise à jour asynchrone. J'ai ajouté waitFor. Deux exécutions de suite passent (12/12).", 1200);
+  use('iris', 'Edit', 'src/api/errors.js', { kind: 'edit', file: 'src/api/errors.js', old: "  throw new Error('request failed');", new: "  throw new ApiError(res.status, friendly(res.status));" },
+      'The file src/api/errors.js has been updated.', { ms: 120, gap: 1500 });
+  say('hugo', "No infinite loop, but there's no backoff: five instant retries hammer the server. And 4xx errors shouldn't retry at all.", "Pas de boucle infinie, mais aucun backoff : cinq retries immédiats martèlent le serveur. Et les erreurs 4xx ne devraient pas être retentées.", 1800);
+  report('hugo', 'iris', 'Retries have no backoff and also retry on 4xx. Suggest exponential backoff and stopping on client errors.', 'Les retries n’ont pas de backoff et retentent aussi sur les 4xx. Je suggère un backoff exponentiel et un arrêt sur les erreurs client.', 1200);
+  use('iris', 'Bash', 'npm test -- api', { kind: 'cmd', text: 'npm test -- api', note: 'Run the API tests' }, ' PASS  src/api/errors.test.js\n PASS  src/api/client.test.js\n\nTests: 18 passed, 18 total', { ms: 1100, gap: 1300 });
+  report('iris', 'main', 'Two unhandled error paths fixed (profile load, checkout) and retries now back off and stop on 4xx. API tests: 18/18.', 'Deux chemins d’erreur non gérés corrigés (chargement du profil, paiement), et les retries ralentissent et s’arrêtent sur les 4xx. Tests API : 18/18.', 1700);
+
+  // --- the lead wraps up ----------------------------------------------------------------
+  todo('main', [['Profile the login flow', 'completed'], ['Fix the flaky cart tests', 'completed'], ['Review API error handling', 'completed'], ['Commit the changes', 'in_progress']], 2200);
+  use('main', 'Edit', 'src/pages/Login.jsx', { kind: 'edit', file: 'src/pages/Login.jsx', old: '    fetchProfile();            // <-- second call, the provider already fetched it\n    fetchNetworks().then(setNetworks);', new: '    fetchNetworks().then(setNetworks);' },
+      'The file src/pages/Login.jsx has been updated.', { ms: 120, gap: 1400 });
+  use('main', 'Bash', 'npm run profile -- login', { kind: 'cmd', text: 'npm run profile -- login', note: 'Check the login speed after the fix' },
+      'login render: 890 ms\n  ├─ fetchProfile   410 ms   (called 1×)\n  ├─ fetchNetworks  380 ms\n  └─ paint          100 ms', { ms: 900, gap: 1200 });
+  use('main', 'Bash', 'git commit -am "Fix slow login and flaky cart tests"', { kind: 'cmd', text: 'git commit -am "Fix slow login and flaky cart tests"', note: 'Commit' },
+      '[fix/login-and-cart 3f2a9c1] Fix slow login and flaky cart tests\n 5 files changed, 38 insertions(+), 12 deletions(-)', { ms: 300, gap: 1300 });
+  say('main', 'Done. Login goes from 3.1 s to 0.9 s, the cart tests pass twice in a row, and two API error paths are handled. Everything is committed on a branch.',
+      'Terminé. Le login passe de 3,1 s à 0,9 s, les tests du panier passent deux fois de suite et deux chemins d’erreur de l’API sont gérés. Tout est commité sur une branche.', 1800);
+
+  events.sort((a, b) => a.ts - b.ts);
+  const merged = [];   // same merging rule as the real timeline: nothing to merge here, each call is its own beat
+  for (const e of events) merged.push(e);
+  const first = merged[0].ts;
+  return { id: 'demo', proj: '_demo', agents, events: merged.map((e) => ({ ...e, t: e.ts - first })), durationMs: merged[merged.length - 1].ts - first };
+};

package/package.json

@@ -1,6 +1,44 @@
 {
   "name": "@double_geste/agent-standup",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.22.0",
+  "description": "Your Claude Code agents as a live video call, from the terminal: a local page in your browser, plus one-line status for status bars. Free, open source, zero token cost.",
+  "bin": {
+    "agent-standup": "bin/agent-standup.js"
+  },
+  "main": "server.js",
+  "files": [
+    "bin",
+    "server.js",
+    "demo.js",
+    "public",
+    "media",
+    "LICENSE",
+    "README.md"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Atoll92/agent-standup.git"
+  },
+  "homepage": "https://atoll92.github.io/agent-standup/",
+  "bugs": {
+    "url": "https://github.com/Atoll92/agent-standup/issues"
+  },
+  "keywords": [
+    "claude-code",
+    "claude",
+    "agents",
+    "sub-agents",
+    "monitoring",
+    "viewer",
+    "statusline",
+    "standup"
+  ],
+  "author": "Double Geste",
+  "publishConfig": {
+    "access": "public"
+  }
+}