@oddessentials/agent-guild 1.9.1 → 1.10.0

package/README.md

@@ -1,34 +1,23 @@
-<p align="center">
-  <img src="docs/images/banner.webp" alt="Agent Guild: Work hard, play hard. An agentic UI that enhances instead of hinders." width="100%">
-</p>
+<h1 align="center">Agent Guild</h1>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@oddessentials/agent-guild"><img src="https://img.shields.io/npm/v/@oddessentials/agent-guild?color=7c5cff&label=npm" alt="npm version"></a>
   <a href="https://github.com/oddessentials/agent-guild/actions/workflows/release.yml"><img src="https://img.shields.io/github/actions/workflow/status/oddessentials/agent-guild/release.yml?branch=main&label=release" alt="Release status"></a>
   <img src="https://img.shields.io/badge/platforms-Windows%20%7C%20macOS%20%7C%20Linux-e8c47c" alt="Windows, macOS and Linux">
   <img src="https://img.shields.io/node/v/@oddessentials/agent-guild?color=4cc38a" alt="Node.js version">
-  <a href="https://www.youtube.com/watch?v=ziT62WtXQ1M"><img src="https://img.shields.io/badge/trailer-watch%20on%20YouTube-e5534b?logo=youtube&logoColor=white" alt="Watch the Agent Guild trailer on YouTube"></a>
-  <a href="https://agentguild.oddessentials.ai/"><img src="https://img.shields.io/badge/Agent%20Guild%3A%20World-coming%20soon%20to%20Steam-1b2838?logo=steam&logoColor=white" alt="Agent Guild: World, coming soon to Steam"></a>
-  <a href="https://oddessentials.ai/donate/?ref=agent-guild"><img src="https://img.shields.io/badge/support-buy%20the%20lab%20a%20beer-f2a93b" alt="Support Agent Guild: buy the lab a beer"></a>
-</p>
-
-<p align="center">
-  <picture>
-    <source media="(prefers-reduced-motion: reduce)" srcset="docs/images/yard-still.webp">
-    <img src="docs/images/yard-clip.webp" alt="Seven coding-agent sessions as characters in the Guild Yard: they leave the plaza for their tools' halls and get to work, then a double-click on one opens Claude Code's real terminal, with its three helper agents" width="100%">
-  </picture>
 </p>
 
-**Every coding agent you run becomes a character in a 3D world, and stays a
-real terminal one double-click away.**
+**Run Claude Code, Codex CLI, Antigravity CLI, Grok Build, Docker Agent and
+your own shells side by side in real terminals. Pick the same live sessions up
+from your phone, VS Code or any browser. Free, on Windows, macOS and Linux.**
 
-**Agent Guild** runs Claude Code, Codex CLI, Antigravity CLI, Grok Build,
-Docker Agent and your own shell side by side, in real terminals, from one
-local web page, or from your phone over Tailscale.
-Close the page whenever you like; the sessions keep running.
+Agent Guild is a small manager that runs on your computer and serves one
+local web page. Close the page whenever you like; the sessions keep running.
 
-[Try the demo](https://oddessentials.github.io/agent-guild/) in your browser
-(simulated, nothing installed) or [watch the trailer](https://www.youtube.com/watch?v=ziT62WtXQ1M).
+<picture>
+  <source media="(prefers-color-scheme: light)" srcset="docs/images/overview-light.webp">
+  <img src="docs/images/overview-dark.webp" alt="Agent Guild with one card per coding tool and six sessions at work">
+</picture>
 
 ## Quick start
 
@@ -41,13 +30,48 @@ agent-guild
 
 The page opens in your browser. Press **New** on a tool's card to start a
 session. Sign in to each tool inside its first session, as you would in any
-terminal.
-
-**[Agent Guild for VS Code](https://marketplace.visualstudio.com/items?itemName=OddEssentials.agent-guild)**
-opens the same page in an editor tab. Editors that install from Open VSX get it
-[there](https://open-vsx.org/extension/OddEssentials/agent-guild).
-
-| Requirement | |
+terminal. To look around first, [try the demo](https://oddessentials.github.io/agent-guild/)
+(simulated, nothing installed) or [watch the trailer](https://www.youtube.com/watch?v=_vQuW0v-uMY).
+
+## Why Agent Guild
+
+* **The real CLIs, unchanged.** Each session is the tool itself in a real
+  terminal, not a chat copy of it. Whatever sign-in the tool uses works: a
+  subscription, an API key, Amazon Bedrock or your own gateway.
+* **Every agent in one place.** Claude Code, Codex CLI, Antigravity CLI, Grok
+  Build, Docker Agent, any shell, and tmux or herdr sessions, each card
+  showing its helper agents and model, with usage meters for Claude Code and
+  Codex CLI.
+* **The same session on every screen.** Any browser, a phone over
+  [Tailscale](#remote-access-with-tailscale) with touch keys, VS Code, and
+  apps for iPhone, iPad and Vision Pro (beta) and
+  [Android](https://github.com/oddessentials/agent-guild-android/releases/latest).
+  Apple Watch and Meta Ray-Ban Display list your sessions and read a
+  session's last answer aloud.
+* **Native on Windows.** No WSL. Also macOS, Linux, and headless Linux
+  servers over SSH.
+* **Nothing in between.** No account and no relay server: the manager
+  listens on `127.0.0.1`, and other devices reach it through your own
+  Tailscale network or reverse proxy. See [Privacy](#privacy).
+
+### How it compares
+
+| | Agent Guild | tmux over SSH | Claude Code Remote Control |
+| --- | --- | --- | --- |
+| Agents | Any CLI, side by side | Any CLI | Claude Code |
+| On a phone | The real terminal in a web page or app, with touch keys | An SSH app | A chat view in the Claude app |
+| Sign-in | Whatever the tool uses | Whatever the tool uses | Pro, Max, Team or Enterprise; [not API keys, Bedrock or a gateway](https://code.claude.com/docs/en/remote-control) |
+| Windows without WSL | Yes | No | Yes |
+
+**Not yet:** push notifications. Phones and the Apple apps reconnect when you
+open them again; the sessions keep running on the computer in the meantime.
+
+**License:** open source under the [GNU AGPL 3.0](LICENSE). Free for
+personal and commercial use.
+
+## Requirements
+
+| | |
 | --- | --- |
 | Node.js | 22 or newer |
 | Windows | 10 version 1809 or later, x64 or arm64. No WSL needed. |
@@ -60,15 +84,9 @@ missing tool shows **Install** on its card; Antigravity CLI, which is not on
 npm, shows its install command instead. For Docker Agent, see
 [Docker Agent](#docker-agent).
 
-<picture>
-  <source media="(prefers-color-scheme: light)" srcset="docs/images/overview-light.webp">
-  <img src="docs/images/overview-dark.webp" alt="Agent Guild with one card per coding tool and six sessions at work">
-</picture>
-
-**[Agent Guild: World](https://agentguild.oddessentials.ai/)**, coming soon to
-Steam, is the premium 3D window onto the same sessions: six worlds to roam
-with a free camera, Steam Workshop crews and companions, and controller
-support, on Windows, macOS and Linux. Agent Guild and its Yard stay free.
+**[Agent Guild for VS Code](https://marketplace.visualstudio.com/items?itemName=OddEssentials.agent-guild)**
+opens the same page in an editor tab. Editors that install from Open VSX get it
+[there](https://open-vsx.org/extension/OddEssentials/agent-guild).
 
 ## Setup
 
@@ -193,7 +211,15 @@ The first Claude Code usage meter may ask for access to the
 
 <img src="docs/images/workspace.webp" alt="Two terminals side by side with the GitHub panel showing the workflow runs of the focused terminal's repository">
 
-<img src="docs/images/yard.webp" alt="The Yard in the Professional skin: a 3D campus with a building for each coding tool, its sessions' characters outside, and the roster and inspector beside it">
+### The Yard
+
+For fun, the Yard shows your tools and sessions as a 3D world, one for each
+skin. A double-click on a character opens its real terminal.
+
+<picture>
+  <source media="(prefers-reduced-motion: reduce)" srcset="docs/images/yard-still.webp">
+  <img src="docs/images/yard-clip.webp" alt="Seven coding-agent sessions as characters in the Guild Yard: they leave the plaza for their tools' halls and get to work, then a double-click on one opens Claude Code's real terminal, with its three helper agents" width="100%">
+</picture>
 
 <table>
   <tr>
@@ -257,6 +283,13 @@ Failed news, model list and release checks retry after 10 minutes.
 * [Skins](docs/SKINS.md): make your own look
 * [Contributing](CONTRIBUTING.md)
 
+## Agent Guild: World
+
+[Agent Guild: World](https://agentguild.oddessentials.ai/), coming soon to
+Steam, is a separate, premium 3D window onto the same sessions: six worlds to
+roam with a free camera, Steam Workshop crews and companions, and controller
+support, on Windows, macOS and Linux. Agent Guild and its Yard stay free.
+
 ## Support
 
 Agent Guild is free to use. If it saves you time,
@@ -265,4 +298,5 @@ tax-deductible donation, and it changes nothing about the software.
 
 ## License
 
-See [LICENSE](LICENSE).
+Copyright (c) 2026 Odd Essentials. Licensed under the
+[GNU Affero General Public License 3.0](LICENSE).

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@oddessentials/agent-guild",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "description": "Launch and watch AI coding-assistant terminal sessions from one local web page. A bundled session manager owns the terminals so the page can close and reconnect.",
-  "license": "SEE LICENSE IN LICENSE",
+  "license": "AGPL-3.0-only",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/oddessentials/agent-guild.git"

package/web/app.js

@@ -3414,10 +3414,10 @@ function closeNews() {
   if ($('news').open) $('news').close();
 }
 
-// Trailers and tutorials ship in web/videos.json, oldest first, and the page lists tutorials first. Nothing
+// Videos ship in web/videos.json, oldest first, and the page groups them like the channel's playlists. Nothing
 // reaches YouTube until the dialog opens, and a video plays only once YouTube's image server has answered for
 // its poster.
-const VIDEO_CATEGORIES = { tutorials: ['Tutorials', 'Tutorial'], trailers: ['Trailers', 'Trailer'] };
+const VIDEO_CATEGORIES = { tutorials: ['Tutorials', 'Tutorial'], trailers: ['Trailers', 'Trailer'], world: ['World', 'World'] };
 const VIDEO_ID = /^[\w-]{11}$/;
 const videosView = { list: [], filter: 'all', selected: null, play: false, poster: 0, opener: null };
 
@@ -3441,8 +3441,22 @@ function videoDate(video) {
   return Number.isNaN(date.getTime()) ? '' : date.toLocaleDateString(undefined, { year: 'numeric', month: 'short', day: 'numeric' });
 }
 
-function videoMeta(video) {
-  return [VIDEO_CATEGORIES[video.category][1], videoDate(video)].filter(Boolean).join(' · ');
+function videoLength(video) {
+  const seconds = video.duration;
+  if (!Number.isInteger(seconds) || seconds <= 0) return '';
+  const [h, m, s] = [Math.floor(seconds / 3600), Math.floor(seconds / 60) % 60, seconds % 60];
+  return [...(h ? [h, String(m).padStart(2, '0')] : [m]), String(s).padStart(2, '0')].join(':');
+}
+
+function videoLengthWords(video) {
+  const seconds = video.duration;
+  if (!videoLength(video) || !Intl.DurationFormat) return videoLength(video);
+  return new Intl.DurationFormat(undefined, { style: 'long' })
+    .format({ hours: Math.floor(seconds / 3600), minutes: Math.floor(seconds / 60) % 60, seconds: seconds % 60 });
+}
+
+function videoMeta(video, length = false) {
+  return [VIDEO_CATEGORIES[video.category][1], length && videoLength(video), videoDate(video)].filter(Boolean).join(' · ');
 }
 
 function shownVideos() {
@@ -3464,21 +3478,30 @@ function renderVideoFilters() {
   }));
 }
 
+function videoItem(video) {
+  const thumb = el('img', 'videos-thumb');
+  thumb.alt = '';
+  thumb.loading = 'lazy';
+  thumb.src = `https://i.ytimg.com/vi/${video.id}/mqdefault.jpg`;
+  thumb.addEventListener('error', () => { thumb.hidden = true; }, { once: true });
+  const length = videoLength(video) ? el('span', 'videos-length', videoLength(video)) : null;
+  length?.setAttribute('aria-hidden', 'true');
+  const item = el('button', 'videos-item', el('span', 'videos-frame', thumb, length),
+    el('span', 'videos-item-text', el('span', 'videos-item-title', video.title),
+      length && el('span', 'visually-hidden', `, ${videoLengthWords(video)}, `), el('span', 'news-meta', videoMeta(video))));
+  item.type = 'button';
+  item.dataset.id = video.id;
+  item.addEventListener('click', () => selectVideo(video, true));
+  if (video === videosView.selected) item.setAttribute('aria-current', 'true');
+  return el('li', null, item);
+}
+
 function renderVideoList() {
-  $('videos-list').replaceChildren(...shownVideos().map((video) => {
-    const thumb = el('img', 'videos-thumb');
-    thumb.alt = '';
-    thumb.loading = 'lazy';
-    thumb.src = `https://i.ytimg.com/vi/${video.id}/mqdefault.jpg`;
-    thumb.addEventListener('error', () => { thumb.hidden = true; }, { once: true });
-    const item = el('button', 'videos-item', el('span', 'videos-frame', thumb),
-      el('span', 'videos-item-text', el('span', 'videos-item-title', video.title), el('span', 'news-meta', videoMeta(video))));
-    item.type = 'button';
-    item.dataset.id = video.id;
-    item.addEventListener('click', () => selectVideo(video, true));
-    if (video === videosView.selected) item.setAttribute('aria-current', 'true');
-    return el('li', null, item);
-  }));
+  const shown = shownVideos();
+  const groups = Object.keys(VIDEO_CATEGORIES).map((id) => [id, shown.filter((video) => video.category === id)]).filter(([, videos]) => videos.length);
+  $('videos-list').replaceChildren(...groups.map(([id, videos]) => el('li', 'videos-group',
+    groups.length > 1 && el('h3', 'videos-group-title', VIDEO_CATEGORIES[id][0]),
+    el('ol', 'videos-group-list', ...videos.map(videoItem)))));
 }
 
 function stopVideo() {
@@ -3494,7 +3517,7 @@ function selectVideo(video, play) {
     else item.removeAttribute('aria-current');
   }
   $('videos-now').textContent = video.title;
-  $('videos-meta').textContent = videoMeta(video);
+  $('videos-meta').textContent = videoMeta(video, true);
   $('videos-youtube').href = `https://www.youtube.com/watch?v=${video.id}`;
   $('videos-play').setAttribute('aria-label', `Play ${video.title}`);
   const request = ++videosView.poster;

package/web/host.js

@@ -7,6 +7,7 @@ export const framed = typeof window !== 'undefined' && window.parent !== window;
 const app = typeof window !== 'undefined' && !framed ? appHost() : null;
 const hosted = framed || Boolean(app);
 export const compact = hosted && document.documentElement?.dataset.layout === 'compact';
+const expandable = hosted && document.documentElement?.dataset.expand !== 'none';
 
 /** The app's message channel, or null. */
 function appHost() {
@@ -48,7 +49,7 @@ export function announceReady(version) {
 }
 
 export function expand(session) {
-  if (hosted) post(session ? { type: 'expand', session } : { type: 'expand' });
+  if (expandable) post(session ? { type: 'expand', session } : { type: 'expand' });
 }
 
 let showView = null;

package/web/index.html

@@ -575,7 +575,7 @@
     <div class="models-bar">
       <div class="models-heading">
         <h2 id="videos-title">Videos</h2>
-        <p id="videos-sub" class="sub"></p>
+        <p class="sub"><span id="videos-sub"></span> · <a id="videos-channel" class="console-link" href="https://www.youtube.com/@Agent-Guild" target="_blank" rel="noopener noreferrer" aria-description="Opens in a new tab">@Agent-Guild on YouTube</a></p>
       </div>
       <button id="videos-close" class="btn" type="button">Close</button>
     </div>

package/web/styles.css

@@ -758,7 +758,7 @@ body:has(#app[hidden]):has(#auth[hidden]):has(#stopped[hidden])::after {
 .models-body { flex: 1 1 auto; min-height: 0; overflow: auto; padding: 0 14px 14px; }
 .remote-access { width: min(560px, calc(100vw - 24px)); max-height: calc(100dvh - 24px); }
 .videos { width: min(1120px, calc(100vw - 32px)); }
-.videos-body { flex: 1 1 auto; min-height: 0; display: grid; grid-template-columns: minmax(0, 1fr) 320px; }
+.videos-body { flex: 1 1 auto; min-height: 0; display: grid; grid-template-columns: minmax(0, 1fr) min(320px, 45%); }
 .videos-stage { display: grid; align-content: start; gap: 12px; min-width: 0; padding: 16px; }
 /* The player keeps 16:9 and gives way to the bar and caption on short windows. */
 .videos-screen {
@@ -785,7 +785,9 @@ body:has(#app[hidden]):has(#auth[hidden]):has(#stopped[hidden])::after {
 .videos-caption h3 { margin: 0; font-size: 1rem; overflow-wrap: anywhere; }
 .videos-caption .news-meta { margin: 3px 0 0; }
 .videos-nav { display: flex; flex-direction: column; min-height: 0; overflow: auto; border-left: 1px solid var(--border); }
-.videos-list { list-style: none; margin: 0; padding: 8px; display: grid; gap: 2px; }
+.videos-list, .videos-group-list { list-style: none; margin: 0; padding: 0; display: grid; gap: 2px; }
+.videos-list { padding: 8px; gap: 10px; }
+.videos-group-title { margin: 4px 6px; color: var(--muted); font-size: 0.72rem; font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase; }
 .videos-item {
   display: grid; grid-template-columns: 128px minmax(0, 1fr); align-items: center; gap: 12px; width: 100%; padding: 6px;
   border: 0; border-radius: calc(var(--radius) - 2px); background: none; color: var(--text); font: inherit; text-align: left; cursor: pointer;
@@ -793,11 +795,15 @@ body:has(#app[hidden]):has(#auth[hidden]):has(#stopped[hidden])::after {
 .videos-item:hover, .videos-item[aria-current="true"] { background: var(--surface-2); }
 .videos-item[aria-current="true"] .videos-frame { outline: 2px solid var(--accent); outline-offset: 1px; }
 .videos-item:focus-visible { outline: 2px solid var(--focus); outline-offset: -2px; }
-.videos-frame { display: block; aspect-ratio: 16 / 9; overflow: hidden; border-radius: 4px; background: var(--surface-2); box-shadow: inset 0 0 0 1px var(--border); }
+.videos-frame { position: relative; display: block; aspect-ratio: 16 / 9; overflow: hidden; border-radius: 4px; background: var(--surface-2); box-shadow: inset 0 0 0 1px var(--border); }
 .videos-thumb { display: block; width: 100%; height: 100%; object-fit: cover; }
+.videos-length {
+  position: absolute; right: 4px; bottom: 4px; padding: 1px 4px; border-radius: 3px;
+  background: rgba(0, 0, 0, 0.78); color: #fff; font-size: 0.68rem; font-weight: 600; line-height: 1.3; font-variant-numeric: tabular-nums;
+}
 .videos-item-title { display: -webkit-box; -webkit-box-orient: vertical; -webkit-line-clamp: 2; overflow: hidden; font-size: 0.85rem; font-weight: 600; line-height: 1.3; }
 .videos-item .news-meta { display: block; margin-top: 3px; white-space: normal; }
-@media (max-width: 900px) {
+@media (max-width: 900px) and (orientation: portrait) {
   .videos-body { display: flex; flex-direction: column; }
   .videos-stage { flex: none; }
   .videos-nav { flex: 1 1 auto; border-left: 0; border-top: 1px solid var(--border); }

package/web/theme.js

@@ -47,6 +47,7 @@
     var asked = params.get('view');
     if (params.get('layout') === 'compact') {
       document.documentElement.dataset.layout = 'compact';
+      if (params.get('expand') === 'none') document.documentElement.dataset.expand = 'none';
       view = 'yard';
       if (skins.some(function (s) { return s.id === params.get('skin'); })) skin = params.get('skin');
       if (params.get('theme') === 'light' || params.get('theme') === 'dark') theme = params.get('theme');

package/web/videos.json

@@ -1,10 +1,16 @@
 {
   "videos": [
-    { "id": "ziT62WtXQ1M", "title": "Agent Guild Trailer", "category": "trailers", "published": "2026-10-01" },
-    { "id": "Zttp-vs_6z0", "title": "Agent Guild - The Yard Update v0.38.0", "category": "trailers", "published": "2026-10-07" },
-    { "id": "mEEI3cuOGzU", "title": "Docker-Agent Joins Agent Guild v0.47.0", "category": "trailers", "published": "2026-10-09" },
-    { "id": "XPSRCpiHokk", "title": "01 - Installation (Windows)", "category": "tutorials", "published": "2026-10-11" },
-    { "id": "5DRFbKgGoUk", "title": "01 - Installation (Linux Headless)", "category": "tutorials", "published": "2026-10-11" },
-    { "id": "QXIH4pv8CDk", "title": "02 - Claude and Codex Install", "category": "tutorials", "published": "2026-10-11" }
+    { "id": "xQ0cBp1wqhA", "title": "Run Them All: Launch Trailer (v0.1.0)", "category": "trailers", "published": "2026-10-01", "duration": 90 },
+    { "id": "5Pg85-_TvRI", "title": "The Yard Update (v0.38.0)", "category": "trailers", "published": "2026-10-07", "duration": 29 },
+    { "id": "C4aAHThCOeo", "title": "Docker Agent Joins the Guild (v0.47.0)", "category": "trailers", "published": "2026-10-09", "duration": 27 },
+    { "id": "unHsaXn4VL4", "title": "Install Agent Guild on Windows (Tutorial 1)", "category": "tutorials", "published": "2026-10-11", "duration": 153 },
+    { "id": "yPnUo7-cpHo", "title": "Add Claude Code and Codex (Tutorial 2)", "category": "tutorials", "published": "2026-10-11", "duration": 125 },
+    { "id": "OJ1n184WVc4", "title": "Run Agent Guild on a Headless Linux Server", "category": "tutorials", "published": "2026-10-11", "duration": 172 },
+    { "id": "n4uXFv6Xgcw", "title": "Agent Guild: World Official Trailer", "category": "world", "published": "2026-10-18", "duration": 62 },
+    { "id": "_vQuW0v-uMY", "title": "Built for Builders: Official Trailer", "category": "trailers", "published": "2026-10-23", "duration": 75 },
+    { "id": "qykaJBmkcM8", "title": "Quests and Glory: The Guild Board and Achievements", "category": "world", "published": "2026-10-23", "duration": 39 },
+    { "id": "tsrkFwj5cgQ", "title": "Use Agent Guild From Your Phone or Anywhere", "category": "tutorials", "published": "2026-10-23", "duration": 263 },
+    { "id": "nwAssNU0OVM", "title": "Happy Thanksgiving! New Workshop Pieces", "category": "world", "published": "2026-10-24", "duration": 43 },
+    { "id": "buiktzLc5yU", "title": "Everywhere: Official Trailer", "category": "trailers", "published": "2026-10-25", "duration": 92 }
   ]
 }