ai-agentmanager 1.7.0 → 1.8.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.8.0 (2026-10-31)
+
+- **Update from your phone:** **Update to …** and **About → Update and restart** now show over remote access too; the install and restart run on the computer and the page reloads when it's back. It installs only the official release, from where this copy came from.
+- **Jira summaries:** an agent created from a Jira link shows the issue's summary as its description (in the list and its header, and as the issue's title under Bugs), fetched in the background from Jira Cloud. Until then, or when it can't be fetched, the words after the link. **Settings → Jira** takes your site, email and API token for private issues (also `JIRA_SITE` / `JIRA_EMAIL` / `JIRA_API_TOKEN`); only `*.atlassian.net` and that site are contacted, and the token goes only to that site. Saving fills in agents already created.
+- **Theme:** Auto / Light / Dark in the ☰ menu, remembered in the browser; diagrams redraw in the theme's colors.
+
 ## 1.7.0 (2026-10-31)
 
 - **Split view:** **◫ Split** in the terminal bar: the terminal (or a shell, or a browser tab) on the left, and Code, Docs (Diagrams by default, or any other document) or Changes on the right. Resizable and remembered.

package/README.md

@@ -7,6 +7,7 @@ Run one background [Claude Code](https://claude.com/claude-code) agent per inten
 ![The conflict radar: two agents changed the same lines of README.md; the AI judge rates it a collision and suggests which lands first](docs/images/conflict-radar.jpg)
 
 - **Intents in, agents out.** Give a list, one per line (say, a ticket each), and each becomes its own `claude` process. Or pick **One agent for all of it** and a long description goes to a single agent as written.
+- **Issue links.** A request that starts with a Jira link is named after the issue (`ABC-123`) and described by its summary, fetched from Jira Cloud (public issues as they are; your company's site after **Settings → Jira**: site, email and API token, kept on this computer and sent only to that site). Without access, the words after the link describe it.
 - **Repo or folder.** Give a git URL (cloned once, then each agent gets its own worktree and branch) or a local folder.
   - **Fast clones.** URLs are cloned as partial clones (`--filter=blob:none`): history now, file contents only for what's checked out.
   - **Progress.** Clone and checkout progress shows in the UI and `agentmgr ls`.
@@ -84,13 +85,13 @@ Runs on macOS and Linux; on Windows, use WSL2. Requires Node 20+, `git`, and the
 
 ```sh
 npm install -g ai-agentmanager          # the latest release
-npm install -g ai-agentmanager@1.7.0    # or a specific one
+npm install -g ai-agentmanager@1.8.0    # or a specific one
 ```
 
 Or from the repository, at a release tag:
 
 ```sh
-git clone --branch v1.7.0 --depth 1 https://github.com/jdmunta/ai-agentmanager-core.git
+git clone --branch v1.8.0 --depth 1 https://github.com/jdmunta/ai-agentmanager-core.git
 cd ai-agentmanager-core
 npm install
 npm link            # optional: puts `agentmgr` on your PATH
@@ -105,12 +106,12 @@ npm install
 npm link
 ```
 
-**Updating.** `agentmgr update` installs the newest release and restarts onto it; running agents pause briefly and resume. In the app, **Update to …** appears in the top bar when a release is out (checked twice a day; turn it off in **☰ → Settings** or with `agentmgr update --auto-check off`), and **About → Update and restart** does the same. A clone at a release tag (or one you `npm link`ed) moves to the newest tag; a clone on a branch or with uncommitted changes is left alone. By hand, use the command for how you installed, then `agentmgr restart`:
+**Updating.** `agentmgr update` installs the newest release and restarts onto it; running agents pause briefly and resume. In the app, **Update to …** appears in the top bar when a release is out (checked twice a day; turn it off in **☰ → Settings** or with `agentmgr update --auto-check off`), and **About → Update and restart** does the same. Both work from a signed-in phone too: the install and restart run on the computer, and the page reloads when it's back. A clone at a release tag (or one you `npm link`ed) moves to the newest tag; a clone on a branch or with uncommitted changes is left alone. By hand, use the command for how you installed, then `agentmgr restart`:
 
 | Installed with | Update |
 | --- | --- |
 | npm | `npm install -g ai-agentmanager@latest` |
-| A clone at a release tag | `git fetch --tags && git checkout v1.7.0 && npm install` (the tag you want) |
+| A clone at a release tag | `git fetch --tags && git checkout v1.8.0 && npm install` (the tag you want) |
 | A clone of `main` | `git pull && npm install` |
 
 **Check your setup.** `agentmgr doctor` checks Node.js, Claude Code and its sign-in, git, `gh`, the data folder, the daemon's port and Chrome, and says how to fix anything missing.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-agentmanager",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "Run background coding agents (Claude Code, Codex) per intent, and keep track of them from a web UI, your phone or the CLI",
   "keywords": [
     "claude",

package/public/app.js

@@ -164,6 +164,18 @@ function checksSummary(b) {
 }
 
 const diagrams = new Map(); // mermaid source -> rendered SVG (or an error)
+/** Whether the page is dark: the menu's choice, else this device's setting. */
+const isDark = () => {
+  const t = document.documentElement.dataset.theme;
+  return t ? t === 'dark' : matchMedia('(prefers-color-scheme: dark)').matches;
+};
+// Diagrams are drawn in the theme's colors: redraw them when it changes.
+window.addEventListener('agentmgr-theme', () => {
+  diagrams.clear();
+  mermaidLib?.initialize({ startOnLoad: false, securityLevel: 'strict', theme: isDark() ? 'dark' : 'default' });
+  for (const el of document.querySelectorAll('[data-mermaid][data-filled]')) delete el.dataset.filled;
+  renderDiagrams(document);
+});
 const expanded = new Set(); // "<agent id>:<section>" the user opened with Show more
 
 /** Long sections are clamped; Show more toggles them. */
@@ -189,7 +201,7 @@ async function renderDiagrams(root) {
       try {
         if (!mermaidLib) {
           mermaidLib = (await import('/vendor/mermaid/mermaid.esm.min.mjs')).default;
-          const dark = matchMedia('(prefers-color-scheme: dark)').matches;
+          const dark = isDark();
           mermaidLib.initialize({ startOnLoad: false, securityLevel: 'strict', theme: dark ? 'dark' : 'default' });
         }
         const { svg } = await mermaidLib.render(`mmd-${diagrams.size}-${Date.now()}`, src);
@@ -638,7 +650,7 @@ function agentItem(a) {
   const idle = !isActive(a);
   return `<li data-id="${a.id}" ${a.kind === 'general' || a.kind === 'assistant' ? '' : 'draggable="true" '}class="agent pr${a.priority ?? 2} ${a.id === selectedId ? 'selected' : ''} ${idle ? 'idle' : ''}">
     <div class="line1">${prioChip(a.priority ?? 2)}${a.results?.outcome === 'blocked' ? '<span class="outcome-mark" title="Blocked">⛔</span>' : a.results?.outcome === 'done' ? '<span class="outcome-mark" title="Done">✅</span>' : ''}<span class="name">${esc(a.name)}</span>${flags(a)}<span class="pill ${st}">${pillText(st)}</span></div>
-    <div class="intent">${a.kind === 'general' ? '<span class="tag">general</span> ' : a.kind === 'assistant' ? '<span class="tag assistant">assistant</span> ' : a.startedBy ? '<span class="tag assistant" title="Started by the assistant">🤖 by assistant</span> ' : a.trigger ? `<span class="tag assistant" title="Started from ${a.trigger.source === 'github' ? 'a labeled GitHub issue' : 'the webhook'}${a.trigger.url ? `: ${esc(a.trigger.url)}` : ''}">⚡ ${a.trigger.source === 'github' ? 'GitHub' : 'webhook'}</span> ` : a.playbook ? `<span class="tag assistant" title="Started by the playbook ${esc(a.playbook.name)}">▶ ${esc(a.playbook.name)}</span> ` : ''}${a.engine && a.engine !== 'claude' ? `<span class="tag engine">${esc(ENGINE_LABEL[a.engine] ?? a.engine)}</span> ` : ''}${esc(a.intent || (a.kind === 'assistant' ? 'Finds new work and starts agents for it' : 'General session'))}</div>
+    <div class="intent" title="${esc(describeTitle(a) ?? '')}">${a.kind === 'general' ? '<span class="tag">general</span> ' : a.kind === 'assistant' ? '<span class="tag assistant">assistant</span> ' : a.startedBy ? '<span class="tag assistant" title="Started by the assistant">🤖 by assistant</span> ' : a.trigger ? `<span class="tag assistant" title="Started from ${a.trigger.source === 'github' ? 'a labeled GitHub issue' : 'the webhook'}${a.trigger.url ? `: ${esc(a.trigger.url)}` : ''}">⚡ ${a.trigger.source === 'github' ? 'GitHub' : 'webhook'}</span> ` : a.playbook ? `<span class="tag assistant" title="Started by the playbook ${esc(a.playbook.name)}">▶ ${esc(a.playbook.name)}</span> ` : ''}${a.engine && a.engine !== 'claude' ? `<span class="tag engine">${esc(ENGINE_LABEL[a.engine] ?? a.engine)}</span> ` : ''}${esc(describe(a) || (a.kind === 'assistant' ? 'Finds new work and starts agents for it' : 'General session'))}</div>
     ${a.status === 'preparing' && a.progress ? `<div class="progress-line">${esc(progressText(a.progress))}</div>` : ''}
     <div class="meta">
       <span class="mono">${a.id}</span>
@@ -1594,7 +1606,7 @@ function renderDetail() {
             ${[0, 1, 2, 3].map((p) => `<option value="${p}" ${p === (a.priority ?? 2) ? 'selected' : ''}>P${p}</option>`).join('')}
           </select>
           <span class="d-name">${esc(a.name)}</span> <span class="pill ${st}">${pillText(st)}</span>${a.kind === 'general' ? ' <span class="tag">general</span>' : ''}</h2>
-        <p class="intent">${esc(a.intent || (a.kind === 'general' ? 'General session: ask Claude anything in the terminal.' : a.kind === 'assistant' ? 'Your assistant: it checks for new work every few minutes and starts agents for it. Settings and activity: Assistant in the top bar.' : ''))}</p>
+        <p class="intent">${a.synopsis?.text ? `<b>${esc(a.synopsis.text)}</b>${a.synopsis.source === 'jira' ? ` <span class="hint">· ${esc(a.synopsis.key)}</span>` : ''}<br><span class="hint">${esc(a.intent)}</span>` : esc(a.intent || (a.kind === 'general' ? 'General session: ask Claude anything in the terminal.' : a.kind === 'assistant' ? 'Your assistant: it checks for new work every few minutes and starts agents for it. Settings and activity: Assistant in the top bar.' : ''))}</p>
       </div>
       <div class="d-actions">
         ${a.status === 'error' && !a.workdir
@@ -3450,7 +3462,8 @@ $('#about-check').onclick = async () => {
   out.hidden = false;
   out.textContent = 'Checking…';
   try {
-    // On this computer the daemon can install it; from a phone, just say what is out.
+    // The daemon checks and can install it (from this computer or a signed-in phone); an older
+    // daemon without /update gets the manual steps.
     const local = await updateUi.check().catch(() => null);
     if (local) return void (out.innerHTML = local);
     const r = await api('GET', '/about/latest');
@@ -4070,6 +4083,10 @@ $('#login-form').addEventListener('submit', async (e) => {
 });
 
 // Engines this machine can run; the New agent form offers a choice once there's more than Claude.
+/** What an agent is about: the issue's summary when its request starts with an issue link, else the request. */
+const describe = (a) => a.synopsis?.text || a.intent;
+const describeTitle = (a) => (a.synopsis?.text ? `${a.synopsis.source === 'jira' ? `${a.synopsis.key} in Jira` : `${a.synopsis.key} (summary not fetched; your words after the link)`}. Request: ${a.intent}` : a.intent);
+
 const ENGINE_LABEL = { claude: 'Claude', codex: 'Codex', antigravity: 'Antigravity', muse: 'Muse Code' };
 async function loadEngines() {
   try {

package/public/index.html

@@ -5,6 +5,13 @@
     <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
     <meta name="apple-mobile-web-app-capable" content="yes" />
     <title>AI Agent Manager</title>
+    <script>
+      // The theme chosen in the menu (Auto / Light / Dark), applied before anything draws.
+      try {
+        const t = localStorage.getItem('agentmgr.theme');
+        if (t === 'light' || t === 'dark') document.documentElement.dataset.theme = t;
+      } catch {}
+    </script>
     <link rel="icon" href="data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 16 16%22%3E%3Cpath d=%22M8 1l7 7-7 7-7-7z%22 fill=%22%233b5bdb%22/%3E%3C/svg%3E" />
     <link rel="manifest" href="/manifest.webmanifest" crossorigin="use-credentials" />
     <meta name="theme-color" content="#151821" />
@@ -17,7 +24,7 @@
       <div class="brand">
         <a href="#" id="home-link" class="home-link" title="Home: all agents"><span class="logo" aria-hidden="true">◆</span><h1>AI Agent Manager</h1></a>
         <button id="about-btn" class="about-btn" type="button" title="About AI Agent Manager: version, release, links">About</button>
-        <button id="update-btn" class="update-btn local-only" type="button" hidden></button>
+        <button id="update-btn" class="update-btn" type="button" hidden></button>
         <span id="conn" class="conn" title="Daemon connection">connecting…</span>
       </div>
       <div class="top-actions">
@@ -42,6 +49,8 @@
             <button role="menuitem" id="alerts-btn" class="local-only" title="Slack alerts when an agent needs you">Alerts…</button>
             <button role="menuitem" id="remote-btn" class="local-only" title="Open AI Agent Manager from your phone">Remote access…</button>
             <div class="menu-sep"></div>
+            <div class="menu-theme"><span>Theme</span><span class="seg" role="radiogroup" aria-label="Theme"><button type="button" data-theme-set="auto" title="Follow this device's setting">Auto</button><button type="button" data-theme-set="light">Light</button><button type="button" data-theme-set="dark">Dark</button></span></div>
+            <div class="menu-sep"></div>
             <button role="menuitem" id="menu-about">About and updates…</button>
           </div>
         </div>
@@ -691,9 +700,9 @@
       <dl id="about-list" class="about-list"></dl>
       <p id="about-update" class="hint" hidden></p>
       <div class="dialog-actions">
-        <label class="about-auto local-only" title="Twice a day, ask for the newest release (GitHub for a git checkout, npm otherwise)"><input type="checkbox" id="about-auto" /> Check automatically</label>
+        <label class="about-auto" title="Twice a day, ask for the newest release (GitHub for a git checkout, npm otherwise)"><input type="checkbox" id="about-auto" /> Check automatically</label>
         <button type="button" id="about-check" class="ghost" title="Asks for the newest release">Check for updates</button>
-        <button type="button" id="about-install" class="primary local-only" hidden>Update and restart</button>
+        <button type="button" id="about-install" class="primary" hidden>Update and restart</button>
         <button type="button" id="about-close" class="primary">Close</button>
       </div>
     </dialog>
@@ -712,6 +721,15 @@
           <p class="hint">After a restart or a crash, the daemon comes back by itself and running agents resume; without it, it starts only when you run <code>agentmgr</code>. <span id="settings-service-state"></span></p>
         </fieldset>
         <fieldset class="local-only">
+          <legend>Jira</legend>
+          <p class="hint">For an agent created from a Jira link, its description shows the issue's summary. Public issues on Atlassian Cloud need nothing here; for your company's site, add it with your email and an <a href="https://id.atlassian.com/manage-profile/security/api-tokens" target="_blank" rel="noopener">API token</a>. The token is kept on this computer and sent only to that site.</p>
+          <div class="row three">
+            <label>Site <input name="jiraSite" placeholder="https://yourcompany.atlassian.net" autocomplete="off" /></label>
+            <label>Email <input name="jiraEmail" type="email" autocomplete="off" /></label>
+            <label>API token <input name="jiraToken" type="password" autocomplete="new-password" /></label>
+          </div>
+        </fieldset>
+        <fieldset>
           <legend>Updates</legend>
           <label class="check"><input type="checkbox" name="updateCheck" /> Check for a new release twice a day</label>
           <p class="hint">Shows <b>Update to …</b> in the top bar; one click installs it and restarts, and running agents resume.</p>

package/public/menu.js

@@ -22,7 +22,8 @@ export function initMenu({ api, esc, toast, $ }) {
   });
   // Any item closes the menu; its own handler does the rest.
   menu.addEventListener('click', (e) => {
-    if (e.target.closest('button')) open(false);
+    // The theme buttons keep it open, to compare.
+    if (e.target.closest('button') && !e.target.closest('[data-theme-set]')) open(false);
   });
   $('#menu-about').onclick = () => $('#about-btn').click();
 
@@ -53,6 +54,7 @@ export function initMenu({ api, esc, toast, $ }) {
   const dialog = $('#settings-dialog');
   const form = $('#settings-form');
   let service = null; // the login service as the dialog opened
+  let jira = null; // the Jira settings as the dialog opened
   $('#settings-btn').onclick = async () => {
     $('#settings-error').hidden = true;
     try {
@@ -60,9 +62,14 @@ export function initMenu({ api, esc, toast, $ }) {
       form.maxRunning.value = c.maxRunning ?? '';
       $('#settings-running').textContent = `Open now: ${c.running}.`;
       service = null;
+      const u = await api('GET', '/update').catch(() => null);
+      form.updateCheck.checked = u?.check !== false;
       if (!remote()) {
-        const u = await api('GET', '/update').catch(() => null);
-        form.updateCheck.checked = u?.check !== false;
+        jira = await api('GET', '/jira').catch(() => null);
+        form.jiraSite.value = jira?.site ?? '';
+        form.jiraEmail.value = jira?.email ?? '';
+        form.jiraToken.value = '';
+        form.jiraToken.placeholder = jira?.hasToken ? 'saved (type to replace)' : '';
         service = await api('GET', '/service').catch(() => null);
         $('#settings-service').hidden = !service?.supported;
         form.startAtLogin.checked = Boolean(service?.installed);
@@ -84,7 +91,11 @@ export function initMenu({ api, esc, toast, $ }) {
     e.preventDefault();
     try {
       const c = await api('PUT', '/cleanup', { maxRunning: form.maxRunning.value.trim() || null });
-      if (!remote()) await api('PUT', '/update', { check: form.updateCheck.checked }).catch(() => {});
+      await api('PUT', '/update', { check: form.updateCheck.checked }).catch(() => {});
+      if (!remote() && jira && (form.jiraSite.value.trim() !== (jira.site ?? '') || form.jiraEmail.value.trim() !== (jira.email ?? '') || form.jiraToken.value.trim())) {
+        await api('PUT', '/jira', { site: form.jiraSite.value.trim(), email: form.jiraEmail.value.trim(), token: form.jiraToken.value.trim() || undefined });
+        toast('Jira saved; summaries for agents from Jira links are being fetched', 4000);
+      }
       // Only when it changed: installing touches launchd / systemd.
       if (!remote() && service?.supported && form.startAtLogin.checked !== Boolean(service.installed)) {
         const s = await api('PUT', '/service', { enabled: form.startAtLogin.checked });
@@ -98,6 +109,31 @@ export function initMenu({ api, esc, toast, $ }) {
     }
   });
 
+  // ------------------------------------------------------------ Theme
+  const THEME_KEY = 'agentmgr.theme';
+  const theme = () => {
+    try {
+      return localStorage.getItem(THEME_KEY) || 'auto';
+    } catch {
+      return 'auto';
+    }
+  };
+  function applyTheme(t) {
+    if (t === 'light' || t === 'dark') document.documentElement.dataset.theme = t;
+    else delete document.documentElement.dataset.theme;
+    for (const b of menu.querySelectorAll('[data-theme-set]')) b.classList.toggle('on', b.dataset.themeSet === t);
+    window.dispatchEvent(new CustomEvent('agentmgr-theme'));
+  }
+  menu.addEventListener('click', (e) => {
+    const b = e.target.closest('[data-theme-set]');
+    if (!b) return;
+    try {
+      localStorage.setItem(THEME_KEY, b.dataset.themeSet);
+    } catch {}
+    applyTheme(b.dataset.themeSet);
+  });
+  applyTheme(theme());
+
   loadMe();
   return { loadMe };
 }

package/public/style.css

@@ -15,8 +15,9 @@
   --mono: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
   color-scheme: light;
 }
+/* Dark: the system's setting unless the page is set to Light, or always when set to Dark (☰ menu). */
 @media (prefers-color-scheme: dark) {
-  :root {
+  :root:not([data-theme="light"]) {
     --bg: #0d0f14;
     --panel: #151821;
     --panel-2: #1c202b;
@@ -31,6 +32,20 @@
     color-scheme: dark;
   }
 }
+:root[data-theme="dark"] {
+  --bg: #0d0f14;
+  --panel: #151821;
+  --panel-2: #1c202b;
+  --border: #2a2f3c;
+  --text: #e5e8ef;
+  --muted: #8b93a7;
+  --accent: #6d8bff;
+  --accent-text: #0d0f14;
+  --green: #3ecf8e;
+  --yellow: #e6b450;
+  --red: #ff6b6b;
+  color-scheme: dark;
+}
 
 * { box-sizing: border-box; }
 [hidden] { display: none !important; }
@@ -873,3 +888,9 @@ form.dropping { outline: 2px dashed var(--accent, #6b8cff); outline-offset: 4px;
 .sd-add { background: rgba(46, 160, 67, .15); }
 .sd-del { background: rgba(248, 81, 73, .15); }
 #term-split-btn.on { background: #262c38; }
+
+/* Theme switch in the menu: Auto / Light / Dark. */
+.menu-theme { display: flex; align-items: center; gap: 6px; padding: 6px 12px; }
+.menu-theme .seg { display: inline-flex; border: 1px solid var(--border); border-radius: 6px; overflow: hidden; margin-left: auto; }
+.menu-theme .seg button { border: 0; border-radius: 0; padding: 3px 9px; font-size: 12px; background: transparent; }
+.menu-theme .seg button.on { background: var(--accent); color: var(--accent-text); }

package/public/update.js

@@ -1,9 +1,9 @@
 // Updating from the app: a button in the top bar when a newer release is out, and "Update and
 // restart" in About. The daemon installs it (git checkout of the release tag, or npm install -g)
-// and restarts onto it; this page then waits for it to come back and reloads.
+// and restarts onto it; this page then waits for it to come back and reloads. It works the same
+// from a phone over remote access: the install runs on the computer.
 
 export function initUpdate({ api, esc, toast, $ }) {
-  const remote = () => document.body.classList.contains('remote');
   let state = null;
 
   function show(s) {
@@ -20,7 +20,6 @@ export function initUpdate({ api, esc, toast, $ }) {
   }
 
   async function load() {
-    if (remote()) return;
     try {
       show(await api('GET', '/update'));
     } catch {
@@ -62,9 +61,8 @@ export function initUpdate({ api, esc, toast, $ }) {
     }
   }
 
-  /** "Check for updates" in About: the daemon's check where it can update itself. */
+  /** "Check for updates" in About: the daemon's check, and whether it can update itself. */
   async function check() {
-    if (remote()) return null;
     const s = await api('POST', '/update/check');
     show(s);
     if (!s.newer) return `You have the newest release (${esc(s.current)}).`;

package/src/jira.js

@@ -0,0 +1,100 @@
+// The summary of the Jira issue a request starts with, so an agent created from a link shows what
+// the issue is about instead of the link. Fetched from Jira Cloud's REST API in the background;
+// when it can't be fetched, the words after the link stand in for it.
+//
+// Only Atlassian Cloud sites (*.atlassian.net) and the site set here are contacted, and the email
+// and API token go only to that site: requests can come from outside (GitHub issues, the
+// assistant), and a link in one must not receive your token or reach internal addresses.
+import fs from 'node:fs';
+import path from 'node:path';
+import { paths } from './config.js';
+import { leadingJiraKey } from './tracker.js';
+
+const file = () => path.join(paths.home, 'jira.json');
+
+/** Saved settings ({ site, email, token }), with JIRA_SITE / JIRA_EMAIL / JIRA_API_TOKEN as fallbacks. */
+export function loadJira(env = process.env) {
+  let saved = {};
+  try {
+    saved = JSON.parse(fs.readFileSync(file(), 'utf8'));
+  } catch {}
+  return {
+    site: normSite(saved.site || env.JIRA_SITE || ''),
+    email: saved.email || env.JIRA_EMAIL || '',
+    token: saved.token || env.JIRA_API_TOKEN || '',
+  };
+}
+
+/** What the page shows: never the token itself. */
+export const jiraView = (j = loadJira()) => ({ site: j.site, email: j.email, hasToken: Boolean(j.token) });
+
+/** Save settings; an empty token keeps the saved one unless `clearToken`. */
+export function saveJira({ site, email, token, clearToken = false } = {}) {
+  const cur = (() => {
+    try {
+      return JSON.parse(fs.readFileSync(file(), 'utf8'));
+    } catch {
+      return {};
+    }
+  })();
+  const next = {
+    site: site === undefined ? cur.site ?? '' : normSite(site),
+    email: email === undefined ? cur.email ?? '' : String(email).trim(),
+    token: clearToken ? '' : token ? String(token).trim() : cur.token ?? '',
+  };
+  if (next.site && !/^https:\/\/[\w.-]+$/.test(next.site)) throw Object.assign(new Error('The Jira site is an https address, like https://yourcompany.atlassian.net'), { status: 400 });
+  fs.mkdirSync(paths.home, { recursive: true });
+  fs.writeFileSync(file(), JSON.stringify(next, null, 2) + '\n', { mode: 0o600 });
+  return jiraView(loadJira());
+}
+
+function normSite(s) {
+  const v = String(s ?? '').trim().replace(/\/+$/, '');
+  if (!v) return '';
+  return /^https?:\/\//.test(v) ? v : `https://${v}`;
+}
+
+/** The issue a request starts with: { key, site } from its leading link, or null. */
+export function leadingIssue(text) {
+  const key = leadingJiraKey(text);
+  if (!key) return null;
+  const url = String(text).trimStart().match(/^<?(https?:\/\/\S+)/)[1];
+  try {
+    return { key, site: new URL(url).origin };
+  } catch {
+    return null;
+  }
+}
+
+/** The person's own words after the leading link ("…/browse/ABC-1 fix the timeout" → "fix the timeout"). */
+export function wordsAfterLink(text) {
+  const rest = String(text ?? '').trimStart().replace(/^<?https?:\/\/\S+>?/, '').trim();
+  return rest.replace(/^[-:–—,\s]+/, '').split('\n')[0].trim().slice(0, 200) || null;
+}
+
+/**
+ * The issue's summary, or null when it can't be had (not a site we contact, no access, offline).
+ * `fetchImpl` and `allow` are for tests.
+ */
+export async function issueSummary({ key, site }, { jira = loadJira(), fetchImpl = fetch, timeoutMs = 6000, allow = null } = {}) {
+  const host = (() => {
+    try {
+      return new URL(site).host;
+    } catch {
+      return '';
+    }
+  })();
+  const configured = jira.site && new URL(jira.site).host === host;
+  const allowed = configured || /\.atlassian\.net$/.test(host) || allow?.(site);
+  if (!allowed) return null;
+  const headers = { accept: 'application/json' };
+  if (configured && jira.email && jira.token) headers.authorization = `Basic ${Buffer.from(`${jira.email}:${jira.token}`).toString('base64')}`;
+  try {
+    const res = await fetchImpl(`${site}/rest/api/3/issue/${encodeURIComponent(key)}?fields=summary`, { headers, redirect: 'error', signal: AbortSignal.timeout(timeoutMs) });
+    if (!res.ok) return null;
+    const summary = (await res.json())?.fields?.summary;
+    return typeof summary === 'string' && summary.trim() ? summary.trim().slice(0, 300) : null;
+  } catch {
+    return null;
+  }
+}

package/src/manager.js

@@ -93,6 +93,7 @@ async function repoLayout(dir) {
 import { spawn } from 'node:child_process';
 import * as git from './git.js';
 import { parseDiff } from '../public/review.js';
+import { issueSummary, leadingIssue, wordsAfterLink } from './jira.js';
 import { conflictMessage, findConflicts, related, repoKey, summarize as summarizeConflicts } from './conflicts.js';
 import { answerMessage, loadQuestions, questionsPath, questionsPrompt } from './inbox.js';
 import { STUCK_DEFAULTS, detectStuck } from './stuck.js';
@@ -667,9 +668,14 @@ export class AgentManager extends EventEmitter {
     };
     for (const pr of refs.prs) agent.prs[pr.url] = { ...pr, source: 'intent' };
     for (const bug of refs.bugs) agent.bugs[bug.key] = { ...bug, source: 'intent' };
+    // A request that starts with an issue link: describe it by the issue's summary (fetched below),
+    // and until then by the words after the link.
+    const issue = leadingIssue(intent);
+    if (issue) agent.synopsis = { text: wordsAfterLink(intent), source: 'request', key: issue.key };
     this.store.put(agent);
     this.registerProject(agent);
     this.changed(agent);
+    if (issue) this.fetchSynopsis(agent.id).catch(() => {});
 
     this.plugins.emit('agent.created', { agent: this.auditView(agent) });
     this.prepare(agent, { start, workspace }).catch(() => {});
@@ -682,6 +688,32 @@ export class AgentManager extends EventEmitter {
     return this.view(agent);
   }
 
+  /** Fetch the summary of the issue an agent's request starts with; it becomes its description. */
+  async fetchSynopsis(ref) {
+    const agent = this.store.get(this.store.resolve(ref)?.id ?? ref);
+    const issue = agent && leadingIssue(agent.intent);
+    if (!issue) return null;
+    const summary = await issueSummary(issue, this.jiraOptions ?? {});
+    const cur = this.store.get(agent.id);
+    if (!summary || !cur) return null;
+    const bug = cur.bugs?.[issue.key];
+    this.patch(cur.id, {
+      synopsis: { text: summary, source: 'jira', key: issue.key },
+      ...(bug && !bug.title ? { bugs: { ...cur.bugs, [issue.key]: { ...bug, title: summary } } } : {}),
+    });
+    return summary;
+  }
+
+  /** Fill in summaries still missing (after Jira settings change); returns how many it found. */
+  async refreshSynopses() {
+    let found = 0;
+    for (const a of this.store.list()) {
+      if (a.synopsis?.source === 'jira' || !leadingIssue(a.intent)) continue;
+      if (await this.fetchSynopsis(a.id).catch(() => null)) found++;
+    }
+    return found;
+  }
+
   prepare(agent, { start, workspace }) {
     const controller = new AbortController();
     const { signal } = controller;

package/src/server.js

@@ -33,6 +33,7 @@ import { Previews, parseUrl } from './preview.js';
 import { LiveBrowser } from './livebrowser.js';
 import * as remote from './remote.js';
 import * as service from './service.js';
+import { jiraView, saveJira } from './jira.js';
 import { Store } from './store.js';
 import { about, latestRelease } from './about.js';
 
@@ -60,7 +61,9 @@ function isAllowedOrigin(origin, port) {
 }
 
 const PUBLIC_REMOTE_API = new Set(['POST /api/login', 'GET /api/session']);
-const LOCAL_ONLY_API = /^\/api\/(remote(\/|$)|notify(\/|$)|hub(\/|$)|triggers(\/|$)|update(\/|$)|service$|editors$|agents\/[\w-]+\/open-in$|shutdown$)/;
+// Updates are not here: a signed-in device (a phone) can install the newest release too. It only
+// ever installs an official release from where this copy came from (git tag or npm) and restarts.
+const LOCAL_ONLY_API = /^\/api\/(remote(\/|$)|notify(\/|$)|hub(\/|$)|triggers(\/|$)|service$|jira$|editors$|agents\/[\w-]+\/open-in$|shutdown$)/;
 const HOOK_PATH = '/api/hooks/agents';
 const NO_REPO_KINDS = new Set(['general', 'assistant']);
 
@@ -508,6 +511,17 @@ export async function startServer({ port = PORT, host = HOST } = {}) {
   api.get('/agents/:id/memory', wrap((req) => memory.read(req.params.id)));
   api.put('/agents/:id/memory', wrap((req) => memory.write(req.params.id, req.body?.text)));
   api.post('/agents/:id/learn', wrap((req) => memory.learn(req.params.id, req.body?.text, { by: req.headers['x-agentmgr-agent'] ? undefined : 'you' })));
+  // Jira: the site and API token used to show an issue's summary for agents created from its link.
+  api.get('/jira', wrap(() => jiraView()));
+  api.put(
+    '/jira',
+    wrap(async (req) => {
+      const view = saveJira(req.body ?? {});
+      // Agents already created from links get their summaries now (in the background).
+      manager.refreshSynopses().catch(() => {});
+      return view;
+    }),
+  );
   // Start at login: the login service (launchd or systemd) that brings the daemon back after a reboot.
   const serviceSupported = ['darwin', 'linux'].includes(process.platform);
   const serviceView = async () => ({ supported: serviceSupported, ...(serviceSupported ? await service.status().catch(() => ({ installed: false, loaded: false })) : { installed: false, loaded: false }) });