@oddessentials/agent-guild 0.2.0 → 0.4.0

package/README.md

@@ -36,6 +36,12 @@ coding tool, and see at a glance which sessions and agents are working.
   not survive a computer restart. **Stop manager** in the top bar stops the
   manager and ends every session; it asks first while any session is still
   running.
+* **Stay current.** When a newer Agent Guild is on npm, an **Upgrade**
+  button appears in the top bar and runs `npm install -g` in a session you
+  can watch. Sessions keep running; stop the manager and run `agent-guild
+  open` to use the new version.
+* **Light or dark.** The page follows your system theme and the top-bar
+  toggle switches it. The guild artwork is the dark theme.
 
 ## Requirements
 
@@ -95,6 +101,10 @@ one platform under a `win32` or `darwin` key. See
 | `modelPattern` | Regular expression that finds the model name on the tool's screen when the tool does not report it. |
 | `resumeArgs` | Arguments that resume the tool's own session, with `{id}` standing for the id, e.g. `["--resume", "{id}"]`. Without it the card has no **Existing** button. |
 | `env` | Extra environment variables for the tool. |
+| `accounts` | Further sign-ins of the tool, each in its own home folder, e.g. `[{ "id": "work", "label": "Work", "dir": "~/.claude-work" }]`. Without `dir`, the folder is `accounts/<provider>/<account>` in the data folder. The card shows one chip per account with its own meters, and a session starts under the chip picked; the tool signs in from inside the first session, and its reporting hooks are copied into the folder on first use. An entry with id `default` renames the tool's own sign-in. Needs `homeVar`. |
+| `homeVar` | The environment variable that moves the tool's home folder, e.g. `CLAUDE_CONFIG_DIR`. Set for Claude Code, Codex CLI, Gemini CLI and Grok Build by default. |
+| `accountEnv` | Further variables set for every account other than the default, with `{dir}` standing for the account's folder. By default Claude Code's secure-storage folder follows the account, and Gemini CLI keeps the account's sign-in in a file rather than the shared OS keychain. |
+| `hooks` | `{ "path", "example" }`: the hooks file inside the home folder and the file in `examples/` copied there for a new account. |
 | `color`, `monogram`, `icon` | Icon appearance. `icon` is a URL path; you can also drop `<id>.svg` into `web/icons/`. |
 | `install`, `docs` | Help shown when the tool is not installed. |
 | `usageUrl`, `billingUrl` | `https://` links to the vendor's usage and billing pages, shown on the card. The defaults point at the subscription pages; set your API console instead, or `null` to hide a link. Google's usage link opens AI Studio, which counts API-key usage only, not the Gemini CLI sign-in quota the card's meters show. |
@@ -102,10 +112,11 @@ one platform under a `win32` or `darwin` key. See
 The page's "Working folder" field sets where new sessions start. It defaults
 to your home folder.
 
-Version checks ask the registry from npm's global configuration (the one
-`npm install -g` uses) about once an hour, and installs use the same
-registry. Set `AGENT_GUILD_NPM_REGISTRY` to override it for both, or
-`AGENT_GUILD_NO_UPDATE_CHECK=1` to skip the checks.
+Version checks, for the tools and for Agent Guild itself, ask the registry
+from npm's global configuration (the one `npm install -g` uses) about once
+an hour, and installs use the same registry. Set `AGENT_GUILD_NPM_REGISTRY`
+to override it for both, or `AGENT_GUILD_NO_UPDATE_CHECK=1` to skip the
+checks.
 
 ## Show agents and models
 
@@ -160,6 +171,8 @@ coding tool in `tests/fixtures`. CI runs them on Windows, macOS and Linux.
 ## Current limits
 
 * Sessions end when the manager stops or the computer restarts.
-* Gemini CLI usage meters need its sign-in in the OS keychain (macOS, or
-  Linux with `secret-tool`) or in the older `oauth_creds.json`; Gemini CLI's
-  encrypted-file storage cannot be read.
+* Gemini CLI usage meters read its sign-in where Gemini CLI keeps it:
+  `oauth_creds.json`, or with `GEMINI_FORCE_ENCRYPTED_FILE_STORAGE=true`
+  the OS keychain (macOS, or Linux with `secret-tool`) or its encrypted
+  credentials file. A sign-in kept in the Windows Credential Manager
+  cannot be read.

package/config/providers.default.json

@@ -8,6 +8,9 @@
       "package": "@anthropic-ai/claude-code",
       "versionArgs": ["--version"],
       "usage": "claude",
+      "homeVar": "CLAUDE_CONFIG_DIR",
+      "accountEnv": { "CLAUDE_SECURESTORAGE_CONFIG_DIR": "{dir}" },
+      "hooks": { "path": "settings.json", "example": "claude-code-settings.json" },
       "modelPattern": "claude-(?:opus|sonnet|haiku|fable|\\d)[a-z0-9.-]*|\\b(?:opus|sonnet|haiku|fable)\\s?\\d+(?:\\.\\d+)?",
       "args": [],
       "resumeArgs": ["--resume", "{id}"],
@@ -41,6 +44,8 @@
       "package": "@openai/codex",
       "versionArgs": ["--version"],
       "usage": "codex",
+      "homeVar": "CODEX_HOME",
+      "hooks": { "path": "hooks.json", "example": "codex-hooks.json" },
       "modelPattern": "\\bgpt-\\d[a-z0-9.-]*",
       "args": [],
       "resumeArgs": ["resume", "{id}"],
@@ -72,6 +77,9 @@
       "package": "@google/gemini-cli",
       "versionArgs": ["--version"],
       "usage": "gemini",
+      "homeVar": "GEMINI_CLI_HOME",
+      "accountEnv": { "GEMINI_FORCE_FILE_STORAGE": "true" },
+      "hooks": { "path": ".gemini/settings.json", "example": "gemini-settings.json" },
       "modelPattern": "\\bgemini-\\d[a-z0-9.-]*",
       "args": [],
       "resumeArgs": ["--resume", "{id}"],
@@ -92,6 +100,8 @@
       "command": "grok",
       "package": "@xai-official/grok",
       "versionArgs": ["--version"],
+      "homeVar": "GROK_HOME",
+      "hooks": { "path": "hooks/agent-guild.json", "example": "grok-hooks.json" },
       "modelPattern": "\\bgrok-(?:build|\\d)[a-z0-9.-]*",
       "args": [],
       "resumeArgs": ["--resume", "{id}"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oddessentials/agent-guild",
-  "version": "0.2.0",
+  "version": "0.4.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": "MIT",
   "repository": {

package/src/manager/config.mjs

@@ -8,10 +8,15 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import crypto from 'node:crypto';
+import { fileURLToPath } from 'node:url';
 
 export const DEFAULT_PORT = 47821;
 export const DEFAULT_HOST = '127.0.0.1';
-export const VERSION = JSON.parse(fs.readFileSync(new URL('../../package.json', import.meta.url), 'utf8')).version;
+/** The package.json the manager runs from; an upgrade replaces it in place. */
+export const PACKAGE_FILE = fileURLToPath(new URL('../../package.json', import.meta.url));
+const packageJson = JSON.parse(fs.readFileSync(PACKAGE_FILE, 'utf8'));
+export const VERSION = packageJson.version;
+export const PACKAGE_NAME = packageJson.name;
 
 /** Per-user data directory. Override with AGENT_GUILD_HOME (used by tests). */
 export function dataDir() {
@@ -37,6 +42,7 @@ export const paths = {
   get token() { return path.join(dataDir(), 'auth-token'); },
   get runtime() { return path.join(dataDir(), 'manager.json'); },
   get providers() { return path.join(dataDir(), 'providers.json'); },
+  get accounts() { return path.join(dataDir(), 'accounts'); },
   get log() { return path.join(dataDir(), 'manager.log'); },
   /** Launchers for agent-guild-report, put first on every session's PATH. */
   get shims() { return path.join(dataDir(), 'bin'); },

package/src/manager/main.mjs

@@ -8,11 +8,15 @@ import { ProviderRegistry } from './providers.mjs';
 import { SessionManager } from './session-manager.mjs';
 import { UsageMonitor } from './usage.mjs';
 import { ModelStats } from './model-stats.mjs';
+import { NewsFeed } from './news.mjs';
 import { createManagerServer } from './server.mjs';
+import { SelfUpdate } from './self-update.mjs';
 import { resolveBaseEnv, pathReader } from './shell-env.mjs';
 import { writeReportShims } from './report-shims.mjs';
 import {
   DEFAULT_HOST,
+  PACKAGE_FILE,
+  PACKAGE_NAME,
   VERSION,
   ensureDataDir,
   loadOrCreateToken,
@@ -27,7 +31,8 @@ const rootDir = path.resolve(here, '../..');
 
 const VERSION_REFRESH_MS = 60 * 60 * 1000;
 
-export async function startManager({ port = resolvePort(), host = DEFAULT_HOST, sessionDefaults } = {}) {
+/** `version` and `packageFile` stand in for the real ones in tests. */
+export async function startManager({ port = resolvePort(), host = DEFAULT_HOST, sessionDefaults, version = VERSION, packageFile = PACKAGE_FILE } = {}) {
   ensureDataDir();
   const token = loadOrCreateToken();
   const baseEnv = resolveBaseEnv();
@@ -51,12 +56,18 @@ export async function startManager({ port = resolvePort(), host = DEFAULT_HOST,
   });
 
   let api;
-  const manager = new SessionManager({ registry, baseEnv, getApiUrl: () => api.url, sessionDefaults, shimDir });
+  const selfUpdate = new SelfUpdate({ pkg: PACKAGE_NAME, version, packageFile, registry });
+  const manager = new SessionManager({ registry, baseEnv, getApiUrl: () => api.url, sessionDefaults, shimDir, selfUpdate });
   const usage = new UsageMonitor({ registry, env: baseEnv });
   const modelStats = new ModelStats({ registry });
+  const news = new NewsFeed({ registry });
   let closing = null;
 
-  const versionTimer = setInterval(() => registry.refreshVersions().catch(() => {}), VERSION_REFRESH_MS);
+  const refreshVersions = () => {
+    registry.refreshVersions().catch(() => {});
+    selfUpdate.refresh().catch(() => {});
+  };
+  const versionTimer = setInterval(refreshVersions, VERSION_REFRESH_MS);
   versionTimer.unref();
 
   const shutdown = (reason = 'shutdown') => {
@@ -82,11 +93,13 @@ export async function startManager({ port = resolvePort(), host = DEFAULT_HOST,
     registry,
     usage,
     modelStats,
+    news,
     token,
     host,
     port,
     webDir,
-    version: VERSION,
+    version,
+    selfUpdate,
     extraOrigins,
     onShutdownRequest: () => shutdown('requested via API').then(() => process.exit(0)),
   });
@@ -106,11 +119,11 @@ export async function startManager({ port = resolvePort(), host = DEFAULT_HOST,
     host,
     port: api.port,
     url: api.url,
-    version: VERSION,
+    version,
     startedAt: new Date().toISOString(),
   });
-  console.log(`[manager] Agent Guild ${VERSION} listening on ${api.url} (pid ${process.pid})`);
-  registry.refreshVersions().catch(() => {});
+  console.log(`[manager] Agent Guild ${version} listening on ${api.url} (pid ${process.pid})`);
+  refreshVersions();
   return { api, manager, registry, token, shutdown };
 }