@elu-labs/elu 0.1.0 → 0.1.1

package/README.md

@@ -5,50 +5,20 @@ use, with bots that review and do work, and teammates you can ask.
 
 ![ELU Code on a made-up project, with stand-in vendors](docs/demo.gif)
 
-Sessions run in the vendors' own unmodified command lines (Claude Code, Codex, Antigravity
-and Grok Build), with your existing sign-in. ELU Code has no account and no telemetry, and
-it never reads your Claude Code sign-in. The Usage tab shows Claude plan usage from what
-Claude Code reports during your sessions. For Codex plan usage, ELU Code starts Codex's own
-`app-server`, which asks with your Codex sign-in, whenever `codex` is installed: when you
-open a project that is set up or send a message, at most once a minute while a session is
-on screen, and from the Usage tab ([what is read and when](SECURITY.md#credentials)).
-
 ## Install
 
-You need macOS or Linux, Node 22 or newer, Git, and at least one vendor command line
-installed and signed in: Claude Code (`claude`) or Codex (`codex`).
-
-Codex must be installed even if your sessions run on Claude Code, but it does not need to
-be signed in. ELU Code runs your project's checks and its pre-push hooks inside Codex's
-sandbox (`codex sandbox`); without it the checks fail and `/publish` refuses. Install it
-with `npm install --global @openai/codex`. To use a copy that is not on your PATH, set
-`ELU_CODE_SANDBOX_HELPER` to its absolute path. On Linux that sandbox is bubblewrap:
-install `bubblewrap` and, on Ubuntu 24.04, load the AppArmor profile in
-[docs/permissions.md](docs/permissions.md#linux). The Linux tests run with both.
-
-GitHub CLI (`gh`) is needed for draft pull requests, and for `@elu` to review and merge a
-fix pull request.
+From your home folder, not inside a project you do not trust:
 
 ```sh
 npx -y @elu-labs/elu
 ```
 
-That opens ELU Code. The first time, it also installs `elu` as a global command: it prints
-the `npm install --global` line it runs, and uses `~/.local` when npm's global folder
-cannot be written. From then on you type `elu`. To open ELU Code without installing
-anything, put `ELU_NO_INSTALL=1` in front of that line.
+This opens ELU Code and installs the `elu` command; next time you type `elu`.
 
-Run that first line from your home folder, not from inside a project you do not trust:
-`npx` lets the folder it starts in decide what runs.
-
-The Usage tab lists the vendor command lines ELU Code found and whether each is signed in.
-Antigravity (`agy`) and Grok Build (`grok`) are checked once on each machine: your first
-message to one starts the check by itself. It takes about seven short turns on that vendor
-and a few minutes. Vendor notes: [docs/vendors](docs/vendors).
-
-Google's FAQ says that using another app to reach Antigravity breaks its terms and can get
-your account suspended or terminated. ELU Code wraps `agy`, so read
-[docs/vendors/antigravity.md](docs/vendors/antigravity.md) before you send it a message.
+You need macOS or Linux, Node 22 or newer, Git, Claude Code signed in, and Codex installed
+(no sign-in needed; its sandbox runs your project's checks):
+`npm install --global @openai/codex`. Using Antigravity? Read
+[its page](docs/vendors/antigravity.md) first. More in [Install details](#install-details).
 
 ## Start
 
@@ -206,8 +176,9 @@ Five come with the app. You can edit or remove any of them in the Bots tab.
   it, and so does `/bots color qa gold`. `/bots color qa random` picks another.
 - `@elu` starts when it joins a session and then runs there every hour. Once ELU Code is
   installed, it runs while ELU Code is closed too, through the login item that runs
-  schedules. `/bots schedule off elu` stops that in one session. It needs the ELU MCP
-  server in Claude Code: `npx @elu-labs/mcp-setup`.
+  schedules. `/bots schedule off elu` stops that in one session. It needs ELU connected:
+  `npx -y @elu-labs/cli --offer=promo` signs you up, or in, adds ELU to your web app and
+  connects your AI tools.
 
 ## Teammates
 
@@ -245,7 +216,49 @@ its path, and it goes with the message: up to 4 pictures, 8 MB each. Your teamma
 sees them when it answers.
 
 In a channel, `/invite @kim` adds a teammate you already have. `/invite` alone makes a
-code for someone new.
+code for someone new; the first time, it also makes your team, named after the open project.
+
+## Install details
+
+Sessions run in the vendors' own unmodified command lines (Claude Code, Codex, Antigravity
+and Grok Build), with your existing sign-in. ELU Code has no account and no telemetry, and
+it never reads your Claude Code sign-in. The Usage tab shows Claude plan usage from what
+Claude Code reports during your sessions. For Codex plan usage, ELU Code starts Codex's own
+`app-server`, which asks with your Codex sign-in, whenever `codex` is installed: when you
+open a project that is set up or send a message, at most once a minute while a session is
+on screen, and from the Usage tab ([what is read and when](SECURITY.md#credentials)).
+
+You need macOS or Linux, Node 22 or newer, Git, and Claude Code (`claude`) installed and
+signed in: new projects and the built-in bots run on it. To run sessions on Codex
+(`codex`), sign in to it and choose it with `/model`.
+
+Codex must be installed even if your sessions run on Claude Code, but it does not need to
+be signed in. ELU Code runs your project's checks and its pre-push hooks inside Codex's
+sandbox (`codex sandbox`); without it the checks fail and `/publish` refuses. Install it
+with `npm install --global @openai/codex`. To use a copy that is not on your PATH, set
+`ELU_CODE_SANDBOX_HELPER` to its absolute path. On Linux that sandbox is bubblewrap:
+install `bubblewrap` and, on Ubuntu 24.04, load the AppArmor profile in
+[docs/permissions.md](docs/permissions.md#linux). The Linux tests run with both.
+
+GitHub CLI (`gh`) is needed for draft pull requests, and for `@elu` to review and merge a
+fix pull request.
+
+The first run of `npx -y @elu-labs/elu` opens ELU Code and installs `elu` as a global
+command: it prints the `npm install --global` line it runs, and uses `~/.local` when npm's
+global folder cannot be written. To open ELU Code without installing anything, run
+`ELU_NO_INSTALL=1 npx -y @elu-labs/elu`.
+
+Run `npx -y @elu-labs/elu` from your home folder, not from inside a project you do not
+trust: `npx` lets the folder it starts in decide what runs.
+
+The Usage tab lists the vendor command lines ELU Code found and whether each is signed in.
+Antigravity (`agy`) and Grok Build (`grok`) are checked once on each machine: your first
+message to one starts the check by itself. It takes about seven short turns on that vendor
+and a few minutes. Vendor notes: [docs/vendors](docs/vendors).
+
+Google's FAQ says that using another app to reach Antigravity breaks its terms and can get
+your account suspended or terminated. ELU Code wraps `agy`, so read
+[docs/vendors/antigravity.md](docs/vendors/antigravity.md) before you send it a message.
 
 ## Update and remove
 

package/lib/default-bots.mjs

@@ -125,7 +125,7 @@ export const DEFAULT_BOTS = Object.freeze([
   { name: 'elu', color: 'pink', about: 'Finds issues in your live product with ELU, then merges or writes the fix', schedule: 'every 1h', mcp: ['elu'], merge: true, instructions: lines(
     'You keep this project free of the issues ELU finds in the live product. ELU (elu.dev) watches real user sessions and reports the problems people run into. You reach it through the MCP server named elu.',
     'On every run:',
-    '1. If you have no tools named mcp__elu__*, say that ELU is not connected, that `npx @elu-labs/mcp-setup` connects it, and stop.',
+    '1. If you have no tools named mcp__elu__*, say that ELU is not connected, that `npx -y @elu-labs/cli --offer=promo` connects it (it signs you up, or in if you have an account, adds ELU to the web app and connects your AI tools), and stop. Do not run it yourself.',
     '2. List the open issues with list_issues, following nextOffset until it is null. Keep the ones that belong to this repository. If there are none, say so in one line and stop.',
     '3. Take the most severe issue you have not handled in this session. Handle one issue per run.',
     '4. If the issue already has a fix pull request (ELU opens one when self-healing is on): read the evidence for the issue, then read the pull request, its diff and its checks with gh. Review it as a careful colleague would: does it fix the reported problem, in the right place, completely, and without touching anything else?',

package/lib/terminal-bots.mjs

@@ -76,7 +76,7 @@ export function botNotes(bot, servers) {
     bot.subagents ? botWorks(bot) ? "Its helpers work under the session's permissions, as the bot does." : 'Its helpers start only when the bot works. Give it a schedule to make it work.' : null,
     botScheduleSpec(bot) ? `Runs by itself in each session it is in. /bots schedule off ${bot.name} stops it in one session.` : botScheduleProblem(bot.schedule),
     bot.mcp.length && bot.vendor !== 'claude' ? onlyClaude(bot.vendor) : null,
-    missing.length ? `${notSetUp(missing)}${missing.includes('elu') ? ` npx @elu-labs/mcp-setup connects ${missing.length > 1 ? 'elu' : 'it'}.` : ''}` : null,
+    missing.length ? `${notSetUp(missing)}${missing.includes('elu') ? ` npx -y @elu-labs/cli --offer=promo connects ${missing.length > 1 ? 'elu' : 'it'}: it signs you up, or in, adds ELU to your web app and connects your AI tools.` : ''}` : null,
     bot.merge ? 'It may merge pull requests. Ask for approval mode still asks you before each merge.' : null,
     bot.shadow ? botShadows(bot) ? SHADOW_NOTE : 'This bot works in its sessions, so it does not speak after each turn.' : null,
   ].filter(Boolean);

package/lib/terminal-visuals.mjs

@@ -112,10 +112,12 @@ export function threadTarget(item, status) {
   const named = teams.flatMap(team => rows(team.members)).find(m => m.key !== status?.key && peerName(m.name, m.key) === peerName(item?.name));
   return named ? dmTarget(named.key) : teams[0] ? roomTarget(teams[0].id, null) : null;
 }
+// What the Team list says before there is a team: how to invite, and how to join.
+export const NO_TEAM = 'No team yet. Invite someone: /invite\nGot a code? /join CODE';
 export function chatBar({ status, items, trusted = [], bots = [] }, width, colour) {
   const line = (text, tone, bold) => ink(fitWords(text, width), tone, colour, bold);
   const teams = rows(status?.teams), trust = new Set(Array.isArray(trusted) ? trusted : []), bar = [], people = new Map(), waiting = new Map(), toneOf = peopleTones(status);
-  if (!teams.length) return [{ line: line('No team yet. elu team create NAME', 'muted'), value: null }];
+  if (!teams.length) return wrapText(NO_TEAM, width).map(text => ({ line: line(text, 'muted'), value: null }));
   // Threads that wait for the owner are counted on their row.
   for (const item of rows(items)) if (NEEDS_OWNER.includes(item.kind)) { const target = threadTarget(item, status); waiting.set(target, (waiting.get(target) ?? 0) + 1); }
   // Who is in a channel, by name: me first, then whoever is online, then the rest. Only people still on the team count.
@@ -204,7 +206,7 @@ export function teamPanes({ status, agents, items, trusted = [], bots = [] }, wi
   if (!threads.length) {
     // An empty channel also says who is in it and how that changes. Sentences share a row while they fit.
     const open = team.find(row => row.value?.target === target)?.value, room = open?.type === 'room' ? open : null;
-    const says = !where ? ['No threads yet. Type a question for your team, or @name for one teammate.'] : [`Nothing in ${where} yet.`, ...(
+    const says = !where ? ['No team yet. Invite someone with /invite, or join with /join CODE.'] : [`Nothing in ${where} yet.`, ...(
       !room ? ['Type below to write to it.']
       : room.channel ? ['Type below to write to it.', 'm changes who is in it.']
       : room.people.length < 2 ? ['Nobody else is on the team yet.', '+ Add teammate invites someone.']

package/lib/terminal.mjs

@@ -111,6 +111,8 @@ export function usageDetailLines(row, now = new Date()) {
 }
 export const geometry = terminalLayout;
 const PEER_OFF = 'Peer mode is off. Type /peer on to start it.';
+// Chats with peer mode off: /invite and /join turn it on themselves.
+const CHATS_OFF = `${PEER_OFF}\nInvite someone: /invite\nGot a code? /join CODE`;
 const NO_PROJECT = 'Create a project first: press n in the Projects tab.';
 const PEER_STOPPED = 'The peer daemon is not running. Run elu peer on.';
 const PEER_MISSING = 'Peer mode needs the optional networking packages. Reinstall with optional dependencies.';
@@ -931,7 +933,7 @@ export async function launchTerminal({ repo, startDirectory = process.cwd(), inp
       // Chats
       teamOn = view === 'chats' && peerData.on;
       teamOff.hidden = view !== 'chats' || teamOn;
-      teamOff.setContent(facade ? stopped ? PEER_STOPPED : PEER_OFF : PEER_MISSING);
+      teamOff.setContent(facade ? stopped ? PEER_STOPPED : CHATS_OFF : PEER_MISSING);
       teamBoxes.forEach((frame, index) => { frame.hidden = !teamOn; frame.style.border.fg = screen.focused === teamLists[index] ? accent : shade('border'); });
       if (teamOn) {
         // The bar lists channels, then each teammate with their live agents. Each pane keeps its selected row while content moves.
@@ -1597,17 +1599,29 @@ export async function launchTerminal({ repo, startDirectory = process.cwd(), inp
   }
   const usageOf = name => COMMANDS.find(row => row.name === name).usage;
   const hasIdentity = () => { try { facade.identity(); return true; } catch (error) { if (/identity first/.test(error.message)) return false; throw error; } };
+  // The name teammates see, asked for the first time peer mode is needed. False when none was given.
+  const askName = async () => {
+    if (typeof facade.identity !== 'function' || hasIdentity()) return true;
+    const name = (await prompt('Your name', 'Teammates see this name on your asks and answers. 1 to 40 characters.', os.userInfo().username))?.trim();
+    if (!name) return false;
+    facade.identity({ create: true, name }); return true;
+  };
+  // Making or using a team code needs peer mode on: a new person gets the name prompt and the daemon started here.
+  const peerReady = async () => {
+    if (!(await askName())) { setMessage('Nothing was done. Your teammates need a name for you.'); return false; }
+    if (peerRead('peerStatus')?.running === true) return true;
+    setMessage('Starting peer mode…'); draw(); await facade.startPeer();
+    for (let i = 0; i < 40 && peerRead('peerStatus')?.running !== true; i++) await new Promise(done => setTimeout(done, 250));
+    if (peerRead('peerStatus')?.running !== true) throw new Error(PEER_STOPPED);
+    return true;
+  };
   // Peer slash commands. Each makes one facade call; the result shows in the status line.
   async function peerSlash({ name, args, text = '' }) {
     if (!facade) throw new Error(PEER_MISSING);
     if (name === 'peer') {
       if (args.length > 1 || args[0] && !['on', 'off'].includes(args[0])) throw new Error('Use /peer, /peer on or /peer off.');
       const turn = args[0] ?? (peerOn() ? 'off' : 'on');
-      if (turn === 'on' && typeof facade.identity === 'function' && !hasIdentity()) {
-        const name = (await prompt('Your name', 'Teammates see this name on your asks and answers. 1 to 40 characters.', os.userInfo().username))?.trim();
-        if (!name) { setMessage('Peer mode stays off. /peer on asks for your name again.'); return; }
-        facade.identity({ create: true, name });
-      }
+      if (turn === 'on' && !(await askName())) { setMessage('Peer mode stays off. /peer on asks for your name again.'); return; }
       await (turn === 'on' ? facade.startPeer() : facade.stopPeer()); setMessage(`Peer mode is ${turn}.`); return;
     }
     if (name === 'share') {
@@ -1616,7 +1630,7 @@ export async function launchTerminal({ repo, startDirectory = process.cwd(), inp
       controller.writable(); const result = await facade.share(controller.repo.root, { handle: args[0], status: true });
       setMessage(`Shared ${shortHome(result?.root ?? controller.repo.root)} with your team as ${remote(result?.handle, 40) || args[0] || path.basename(controller.repo.root)}.`); return;
     }
-    if (!peerOn()) throw new Error(PEER_OFF);
+    if (!peerOn() && !['invite', 'join'].includes(name)) throw new Error(PEER_OFF);
     if (name === 'peers') {
       const status = peerRead('peerStatus'), members = new Map();
       for (const member of (status?.teams ?? []).flatMap(row => row?.members ?? [])) if (member?.key && member.key !== status.key) members.set(member.key, member);
@@ -1629,21 +1643,29 @@ export async function launchTerminal({ repo, startDirectory = process.cwd(), inp
       try { controller.writable(); const row = await facade.share(controller.repo.root, { teams: [teamId] }); return `Teammates can ask about ${remote(row?.handle, 40) || path.basename(controller.repo.root)}, the folder ${shortHome(row?.root ?? controller.repo.root)}.`; }
       catch (error) { return `${path.basename(controller.repo.root)} is not shared: ${error.message}`; }
     };
+    const firstTeam = async () => {
+      const named = controller ? path.basename(controller.repo.root).slice(0, 60) : '';
+      try { if (named) return await facade.createTeam(named); } catch {}
+      return facade.createTeam('My team');
+    };
     if (name === 'invite') {
       const teams = peerRead('peerStatus')?.teams ?? [];
+      if (!teams.length && args.length) throw new Error('No team yet. /invite alone starts one and makes a code to send.');
+      if (!(await peerReady())) return;
       // A name adds a teammate to the open channel: @name always, a bare word unless a team is called that.
       if (teams.length && args.length === 1 && (args[0].startsWith('@') || !teams.some(row => row.id === args[0] || row.name === args[0]))) return inviteToChannel(args[0]);
-      const chosen = args.length ? teams.find(row => row.id === args[0] || row.name === args.join(' ')) : teams[0];
-      if (!chosen) throw new Error(teams.length ? 'No team by that name.' : 'Create a team first: elu team create NAME.');
+      // The first /invite makes the team, so nobody has to name one: it is named after the open project.
+      const chosen = args.length ? teams.find(row => row.id === args[0] || row.name === args.join(' ')) : teams[0] ?? await firstTeam();
+      if (!chosen) throw new Error('No team by that name.');
       const result = await facade.createInvite(chosen.id, { hours: 24 }), code = typeof result === 'string' ? result : result?.code;
       if (typeof code !== 'string' || !code.startsWith('elu-team:')) throw new Error('The invite could not be made.');
       const shared = await teamShare(chosen.id), bots = await shareBots();
       setMessage(`Invite for ${remote(chosen.name, 40)} ready. It works once, within 24 h.`);
-      await prompt('Team invite', `${code}\n\nOne use, expires in 24 h.\n${shared}\n${bots ? `${bots}\n` : ''}Your teammate types /join and this code in the project you can ask about.\nStay online until they join.`); return;
+      await prompt('Team invite', `${code}\n\nOne use, expires in 24 h.\n${shared}\n${bots ? `${bots}\n` : ''}Send this code to your teammate. On their computer:\n1. Open a terminal in the project folder they will share with you.\n2. Run npx -y @elu-labs/elu\n3. In ELU Code, type /join and this code.\nStay online until they join.`); return;
     }
     if (name === 'join') {
       if (args.length !== 1 || !args[0].startsWith('elu-team:')) throw new Error(`Use ${usageOf('join')}.`);
-      if (peerRead('peerStatus')?.running !== true) throw new Error(PEER_STOPPED);
+      if (!(await peerReady())) return;
       setMessage('Joining the team…'); draw();
       const joined = await facade.joinTeam(args[0]);
       const shared = await teamShare(joined?.id), bots = await shareBots();

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@elu-labs/elu",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@elu-labs/elu",
-      "version": "0.1.0",
+      "version": "0.1.1",
       "license": "MIT",
       "os": [
         "darwin",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elu-labs/elu",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A full-screen terminal app that runs coding sessions on the AI command lines you already use, with bots that review and do work, and teammates you can ask.",
   "keywords": [
     "ai",