agentlab 0.2.1 → 0.2.3

package/README.md

@@ -1,19 +1,74 @@
 # AgentLab
 
-One captain for all your coding agents in a fast local terminal UI.
+One captain per project folder, with Codex, Claude Code, and OpenCode in one local terminal.
+
+AgentLab lets you switch between projects and run multiple coding-agent sessions while keeping their
+real CLIs accessible. Each project points to a folder on your machine. It has one captain and any
+number of workers.
+
+## Install
 
 ```bash
 npm install --global agentlab
 agentlab
 ```
 
-The npm launcher downloads the matching AgentLab executable on first use, verifies its
-package-pinned size and SHA-256 digest, and caches it by version. It rechecks the cached digest
-before execution. Linux x64 with glibc and Apple-silicon macOS are supported. AgentLab requires
-`tmux` and at least one authenticated provider CLI: Codex, Claude Code, or OpenCode.
+Run `agentlab` from any directory. The app opens to the project picker and waits for you to choose a
+folder. On first launch, the npm package downloads the matching AgentLab executable from GitHub and
+caches it. The installer shows the percentage, downloaded size, and download speed while it works.
+Later launches use the cached executable.
+
+## Requirements
+
+- Linux x64 with glibc, or macOS on Apple silicon
+- Node.js 20 or newer
+- `tmux`
+- At least one installed and authenticated provider CLI: `codex`, `claude`, or `opencode`
+- A terminal at least 90 columns by 18 rows
+
+Install tmux with `brew install tmux` on macOS or your Linux distribution's package manager.
+
+## Start a project
+
+1. Run `agentlab`.
+2. Press `Alt+N` and enter the path to an existing folder. The folder can be anywhere on your
+   machine.
+3. Name the project and choose its captain provider, model, and reasoning level.
+4. Add workers with `Alt+W` when the captain needs more sessions.
+5. Switch projects from the left sidebar. Each project keeps its captain and workers together.
+
+Removing a project stops its managed sessions and forgets it in AgentLab. The project folder and its
+files stay untouched.
+
+## Keys
+
+| Key                       | Action                                        |
+| ------------------------- | --------------------------------------------- |
+| `Alt+1`, `Alt+2`, `Alt+3` | Focus projects, terminal, or agents           |
+| `Up`, `Down`, `Enter`     | Navigate a focused sidebar and enter terminal |
+| `Alt+N`                   | Add a project folder                          |
+| `Alt+W`                   | Add a worker to the selected project          |
+| `Delete`                  | Remove the selected project or worker         |
+| `Alt+C`                   | Copy the terminal selection                   |
+| `Alt+Q`                   | Quit AgentLab                                 |
+
+## Updates
+
+AgentLab updates only when you ask it to:
+
+```bash
+agentlab update --check
+agentlab update
+```
+
+Normal startup does not check for updates.
+
+## Local data
 
-Use `agentlab update` for an explicit update or `agentlab update --check` to check without changing
-the installation. Normal cached startup performs no update request.
+AgentLab opens no network listener. It stores the project list in a local SQLite database, keeps
+provider credentials in each CLI's existing authentication store, and runs agent sessions through
+tmux.
 
-See [the AgentLab repository](https://github.com/RiadMefti/agentlab) for usage, release checksums,
-SBOMs, and build provenance.
+Read the [documentation](https://github.com/RiadMefti/agentlab#readme), browse
+[releases](https://github.com/RiadMefti/agentlab/releases), or
+[report a problem](https://github.com/RiadMefti/agentlab/issues).

package/dist/cache.js

@@ -32,6 +32,7 @@ export async function ensureCachedBinary(manifest, key, options = {}) {
     const fetchImplementation = options.fetch ?? globalThis.fetch;
     const downloadUrl = releaseDownloadUrl(manifest, key);
     try {
+        options.onDownloadProgress?.({ downloadedBytes: 0, totalBytes: target.size });
         const response = await fetchImplementation(downloadUrl, {
             redirect: "follow",
             signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT_MILLISECONDS)
@@ -62,6 +63,7 @@ export async function ensureCachedBinary(manifest, key, options = {}) {
                 }
                 hash.update(chunk);
                 await writeAll(file, chunk);
+                options.onDownloadProgress?.({ downloadedBytes: size, totalBytes: target.size });
             }
             await file.sync();
         }

package/dist/cli.js

@@ -4,6 +4,7 @@ import { readFile } from "node:fs/promises";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { ensureCachedBinary, resolveCacheRoot } from "./cache.js";
+import { InstallProgressReporter } from "./install-progress.js";
 import { currentRuntimePlatform, parseReleaseManifest, resolveRuntimeTarget } from "./manifest.js";
 const REGISTRY_LATEST_URL = "https://registry.npmjs.org/agentlab/latest";
 const STABLE_VERSION_PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/u;
@@ -32,10 +33,28 @@ export async function runLauncher(args, options = {}) {
     }
     const runtime = options.runtime ?? currentRuntimePlatform();
     const target = resolveRuntimeTarget(runtime);
-    const binary = await ensureCachedBinary(manifest, target, {
-        cacheRoot: options.cacheRoot ?? resolveCacheRoot(environment),
-        fetch: options.fetch
+    const stderr = options.stderr ?? ((message) => process.stderr.write(message));
+    const progress = new InstallProgressReporter({
+        isTTY: options.stderrIsTTY ?? (options.stderr === undefined && process.stderr.isTTY),
+        target,
+        version: packageVersion,
+        write: stderr
     });
+    let binary;
+    try {
+        binary = await ensureCachedBinary(manifest, target, {
+            cacheRoot: options.cacheRoot ?? resolveCacheRoot(environment),
+            fetch: options.fetch,
+            onDownloadProgress: (downloadProgress) => {
+                progress.report(downloadProgress);
+            }
+        });
+    }
+    catch (error) {
+        progress.clear();
+        throw error;
+    }
+    progress.complete();
     return execute(binary, args, {
         ...environment,
         AGENTLAB_INSTALL_METHOD: "npm",

package/dist/install-progress.js

@@ -0,0 +1,82 @@
+import { performance } from "node:perf_hooks";
+const BAR_WIDTH = 16;
+const BYTES_PER_MEGABYTE = 1_000_000;
+const MINIMUM_RENDER_INTERVAL_MILLISECONDS = 100;
+const CLEAR_LINE = "\r\u001B[2K";
+const targetLabels = {
+    "linux-x64": "Linux x64",
+    "mac-arm64": "macOS arm64"
+};
+export class InstallProgressReporter {
+    isTTY;
+    now;
+    targetLabel;
+    version;
+    write;
+    active = false;
+    finished = false;
+    lastRenderAt;
+    startedAt;
+    constructor(options) {
+        this.isTTY = options.isTTY;
+        this.now = options.now ?? (() => performance.now());
+        this.targetLabel = targetLabels[options.target];
+        this.version = options.version;
+        this.write = options.write;
+    }
+    report(progress) {
+        if (this.finished)
+            return;
+        const now = this.now();
+        if (!this.active) {
+            this.active = true;
+            this.startedAt = now;
+            if (!this.isTTY) {
+                this.write(`Downloading AgentLab ${this.version} for ${this.targetLabel} (${formatMegabytes(progress.totalBytes)} MB)...\n`);
+                return;
+            }
+        }
+        if (!this.isTTY)
+            return;
+        const complete = progress.downloadedBytes >= progress.totalBytes;
+        if (!complete &&
+            this.lastRenderAt !== undefined &&
+            now - this.lastRenderAt < MINIMUM_RENDER_INTERVAL_MILLISECONDS) {
+            return;
+        }
+        this.lastRenderAt = now;
+        this.write(`${CLEAR_LINE}${renderProgress(progress, now - (this.startedAt ?? now), this.version)}`);
+    }
+    complete() {
+        if (!this.active || this.finished)
+            return;
+        this.finished = true;
+        if (this.isTTY)
+            this.write(CLEAR_LINE);
+        const marker = this.isTTY ? "✓ " : "";
+        this.write(`${marker}AgentLab ${this.version} installed for ${this.targetLabel}.\n`);
+        this.write("Starting AgentLab...\n");
+    }
+    clear() {
+        if (!this.active || this.finished)
+            return;
+        this.finished = true;
+        if (this.isTTY)
+            this.write(CLEAR_LINE);
+    }
+}
+function renderProgress(progress, elapsedMilliseconds, version) {
+    const ratio = clamp(progress.downloadedBytes / progress.totalBytes, 0, 1);
+    const filled = ratio === 1 ? BAR_WIDTH : Math.floor(ratio * BAR_WIDTH);
+    const bar = `${"█".repeat(filled)}${"░".repeat(BAR_WIDTH - filled)}`;
+    const percent = Math.floor(ratio * 100);
+    const elapsedSeconds = Math.max(elapsedMilliseconds / 1_000, 0.001);
+    const megabytesPerSecond = progress.downloadedBytes / BYTES_PER_MEGABYTE / elapsedSeconds;
+    return `Downloading AgentLab ${version} [${bar}] ${String(percent).padStart(3)}% ${formatMegabytes(progress.downloadedBytes)}/${formatMegabytes(progress.totalBytes)} MB ${megabytesPerSecond.toFixed(1)} MB/s`;
+}
+function formatMegabytes(bytes) {
+    return (bytes / BYTES_PER_MEGABYTE).toFixed(1);
+}
+function clamp(value, minimum, maximum) {
+    return Math.min(Math.max(value, minimum), maximum);
+}

package/package.json

@@ -1,7 +1,18 @@
 {
   "name": "agentlab",
-  "version": "0.2.1",
-  "description": "One captain for all your coding agents in a fast local terminal UI.",
+  "version": "0.2.3",
+  "description": "Run Codex, Claude Code, and OpenCode in one local terminal, with one captain per project.",
+  "keywords": [
+    "ai",
+    "coding-agents",
+    "codex",
+    "claude-code",
+    "opencode",
+    "multi-agent",
+    "terminal",
+    "tui",
+    "tmux"
+  ],
   "type": "module",
   "bin": {
     "agentlab": "dist/agentlab.js"
@@ -21,12 +32,13 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/RiadMefti/agentlab.git"
+    "url": "git+https://github.com/RiadMefti/agentlab.git",
+    "directory": "packages/launcher"
   },
   "bugs": {
     "url": "https://github.com/RiadMefti/agentlab/issues"
   },
-  "homepage": "https://github.com/RiadMefti/agentlab#readme",
+  "homepage": "https://github.com/RiadMefti/agentlab",
   "publishConfig": {
     "access": "public"
   }

package/release-manifest.json

@@ -2,15 +2,15 @@
   "repository": "RiadMefti/agentlab",
   "targets": {
     "linux-x64": {
-      "asset": "agentlab-v0.2.1-linux-x64",
-      "sha256": "a05e7c4a02a33fe4859afa1af84ae247f17b1c7f04e7c0926cd5ca8bc2fc13a9",
+      "asset": "agentlab-v0.2.3-linux-x64",
+      "sha256": "c4da3d5e1d5191a3316fc4c6db4d40b73dabb8eb882354fa67c918097944b5ec",
       "size": 116298952
     },
     "mac-arm64": {
-      "asset": "agentlab-v0.2.1-mac-arm64",
-      "sha256": "c12654c6a41fe72170b4cc720316eefec1f1af6ce7518e661cca4e3900360552",
+      "asset": "agentlab-v0.2.3-mac-arm64",
+      "sha256": "b6ebe1fc40338c16a9fbfe7da7cc0b79c9a93d516387f61a0cdc4a3fae30ca7c",
       "size": 77351282
     }
   },
-  "version": "0.2.1"
+  "version": "0.2.3"
 }