npm - agent-office-studio - Versions diffs - 0.0.0-stage → 0.2.0 - Mend

agent-office-studio 0.0.0-stage → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (67) hide show

package/CHANGELOG.md +57 -0
package/LICENSE +21 -0
package/README.md +85 -2
package/bin/agentoffice.js +38 -0
package/dist/apple-touch-icon.png +0 -0
package/dist/assets/_commonjsHelpers-CqkleIqs.js +1 -0
package/dist/assets/addon-fit-BwprjgOP.js +1 -0
package/dist/assets/index-CozPk6R9.js +4457 -0
package/dist/assets/index-i7sU9SN-.css +32 -0
package/dist/assets/inter-cyrillic-ext-wght-normal-B2xhLi22.woff2 +0 -0
package/dist/assets/inter-cyrillic-wght-normal-CMZtQduZ.woff2 +0 -0
package/dist/assets/inter-greek-ext-wght-normal-CGAr0uHJ.woff2 +0 -0
package/dist/assets/inter-greek-wght-normal-CaVNZxsx.woff2 +0 -0
package/dist/assets/inter-latin-ext-wght-normal-CFHvXkgd.woff2 +0 -0
package/dist/assets/inter-latin-wght-normal-C2S99t-D.woff2 +0 -0
package/dist/assets/inter-vietnamese-wght-normal-CBcvBZtf.woff2 +0 -0
package/dist/assets/jetbrains-mono-cyrillic-400-normal-BEIGL1Tu.woff2 +0 -0
package/dist/assets/jetbrains-mono-cyrillic-400-normal-CIEtRijs.woff +0 -0
package/dist/assets/jetbrains-mono-greek-400-normal-C190GLew.woff2 +0 -0
package/dist/assets/jetbrains-mono-greek-400-normal-CNojz0t3.woff +0 -0
package/dist/assets/jetbrains-mono-latin-400-normal-B11XCQ5g.woff +0 -0
package/dist/assets/jetbrains-mono-latin-400-normal-V6pRDFza.woff2 +0 -0
package/dist/assets/jetbrains-mono-latin-ext-400-normal-Bc8Ftmh3.woff2 +0 -0
package/dist/assets/jetbrains-mono-latin-ext-400-normal-DHMOLxAi.woff +0 -0
package/dist/assets/jetbrains-mono-vietnamese-400-normal-BeU3T8wf.woff +0 -0
package/dist/assets/xterm-C7kOH91j.js +9 -0
package/dist/icon-192.png +0 -0
package/dist/icon-512.png +0 -0
package/dist/icon.svg +9 -0
package/dist/index.html +240 -0
package/dist/manifest.webmanifest +16 -0
package/dist/sw.js +39 -0
package/docs/README.md +26 -0
package/docs/claude-access.md +31 -0
package/docs/configuration.md +53 -0
package/docs/development.md +76 -0
package/docs/getting-started.md +54 -0
package/docs/guides/troubleshooting.md +99 -0
package/docs/guides/updating.md +36 -0
package/docs/guides/working-with-the-team.md +56 -0
package/docs/guides/your-first-job.md +65 -0
package/docs/how-it-works.md +80 -0
package/docs/images/office.jpg +0 -0
package/docs/jobs.md +54 -0
package/docs/leaderboard.md +65 -0
package/docs/packaging.md +49 -0
package/docs/phone.md +28 -0
package/docs/security.md +48 -0
package/docs/terminal.md +46 -0
package/docs/using-the-office.md +109 -0
package/docs/voice.md +44 -0
package/package.json +64 -4
package/server/auth.js +89 -0
package/server/banter.js +53 -0
package/server/changes.js +72 -0
package/server/chief.js +130 -0
package/server/index.js +1952 -0
package/server/leaderboard.js +190 -0
package/server/office-mcp.js +101 -0
package/server/procstat.js +85 -0
package/server/standup.js +78 -0
package/server/supervise.js +51 -0
package/server/terminal.js +255 -0
package/server/tools.js +52 -0
package/server/usage.js +40 -0
package/server/voice.js +172 -0
package/shared/speakable.js +50 -0

package/dist/icon-192.png ADDED Viewed

Binary file

package/dist/icon-512.png ADDED Viewed

Binary file

package/dist/icon.svg ADDED Viewed

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512">
+  <rect width="512" height="512" fill="#1d1b18"/>
+  <rect x="136" y="160" width="240" height="176" rx="32" fill="#fbf9f5"/>
+  <rect x="216" y="336" width="80" height="28" fill="#fbf9f5"/>
+  <rect x="180" y="356" width="152" height="24" rx="12" fill="#fbf9f5"/>
+  <circle cx="206" cy="248" r="16" fill="#1d1b18"/>
+  <circle cx="256" cy="248" r="16" fill="#1d1b18"/>
+  <circle cx="306" cy="248" r="16" fill="#1d1b18"/>
+</svg>

package/dist/index.html ADDED Viewed

@@ -0,0 +1,240 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
+    <meta name="theme-color" content="#fbf9f5" />
+    <meta name="mobile-web-app-capable" content="yes" />
+    <meta name="apple-mobile-web-app-capable" content="yes" />
+    <meta name="apple-mobile-web-app-status-bar-style" content="default" />
+    <meta name="apple-mobile-web-app-title" content="Office" />
+    <link rel="manifest" href="/manifest.webmanifest" />
+    <link rel="icon" href="/icon.svg" type="image/svg+xml" />
+    <link rel="apple-touch-icon" href="/apple-touch-icon.png" />
+    <script>
+      // Before first paint, so a saved theme never flashes the default. theme.js owns it after that.
+      (function () {
+        try {
+          var t = localStorage.getItem('office.theme') || 'paper';
+          var m = localStorage.getItem('office.mode') || 'auto';
+          var d = m === 'dark' || (m === 'auto' && matchMedia('(prefers-color-scheme: dark)').matches);
+          var r = document.documentElement;
+          r.dataset.theme = t;
+          r.dataset.mode = d ? 'dark' : 'light';
+        } catch (e) {}
+      })();
+    </script>
+    <title>Agent Office</title>
+    <script type="module" crossorigin src="/assets/index-CozPk6R9.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-i7sU9SN-.css">
+  </head>
+  <body>
+    <div class="app" id="app" data-m="office">
+      <aside class="side">
+        <header class="brand">
+          <div class="title">
+            <h1>Agent Office</h1>
+            <span class="title-end">
+              <span class="lv" id="lv">Lv 1</span>
+              <button type="button" class="theme-btn" id="lbBtn" aria-label="Leaderboard" aria-haspopup="true" aria-expanded="false" title="Leaderboard">
+                <svg viewBox="0 0 24 24"><path d="M8 4h8v5a4 4 0 0 1-8 0z"/><path d="M8 6H5v1a3 3 0 0 0 3 3"/><path d="M16 6h3v1a3 3 0 0 1-3 3"/><path d="M12 13v4"/><path d="M8.5 20h7"/></svg>
+              </button>
+              <button type="button" class="theme-btn" id="acctBtn" aria-label="Claude access" aria-haspopup="true" aria-expanded="false" title="Claude access">
+                <svg viewBox="0 0 24 24"><circle cx="8" cy="15" r="4"/><path d="M10.8 12.2 20 3"/><path d="m17 6 3 3"/><path d="m14.5 8.5 2 2"/></svg>
+              </button>
+              <button type="button" class="theme-btn" id="themeBtn" aria-label="Appearance" aria-haspopup="true" aria-expanded="false" title="Appearance">
+                <svg viewBox="0 0 24 24"><path d="M12 3a9 9 0 1 0 0 18c1.4 0 2-.9 2-1.8 0-.9-.6-1.3-.6-2.2 0-1 .8-1.6 1.8-1.6H17a4 4 0 0 0 4-4C21 6.7 17 3 12 3z"/><circle cx="7.5" cy="11" r="1"/><circle cx="10" cy="7" r="1"/><circle cx="15" cy="7.5" r="1"/></svg>
+              </button>
+            </span>
+            <div class="theme-pop" id="themePop" role="dialog" aria-label="Appearance" hidden></div>
+            <div class="theme-pop lb-pop" id="lbPop" role="dialog" aria-label="Leaderboard" hidden></div>
+            <div class="theme-pop acct-pop" id="acctPop" role="dialog" aria-label="Claude access" hidden></div>
+          </div>
+          <div class="level">
+            <div class="xpbar"><i id="xpbar"></i></div>
+            <span class="xp" id="xptext">0 / 100 XP</span>
+          </div>
+          <div class="usage" id="usage" aria-label="Plan usage">
+            <div class="meter" id="useSession">
+              <span class="k">Session</span>
+              <span class="v"></span>
+              <div class="bar"><i></i></div>
+              <span class="r"></span>
+            </div>
+            <div class="meter" id="useWeek">
+              <span class="k">Week</span>
+              <span class="v"></span>
+              <div class="bar"><i></i></div>
+              <span class="r"></span>
+            </div>
+            <p class="u-err" id="useErr" hidden></p>
+          </div>
+          <div class="usage" id="load" aria-label="What the agents are using on this machine" hidden>
+            <div class="meter" id="loadCpu">
+              <span class="k">CPU</span>
+              <span class="v"></span>
+              <div class="bar"><i></i></div>
+              <span class="r"></span>
+            </div>
+            <div class="meter" id="loadMem">
+              <span class="k">Memory</span>
+              <span class="v"></span>
+              <div class="bar"><i></i></div>
+              <span class="r"></span>
+            </div>
+          </div>
+        </header>
+        <nav class="tabs">
+          <button type="button" data-tab="chat" class="on">Chat</button>
+          <button type="button" data-tab="jobs">Jobs <span id="jobCount"></span></button>
+          <button type="button" data-tab="projects">Projects</button>
+          <button type="button" data-tab="team">Team</button>
+        </nav>
+        <section class="pane" id="chatPane">
+          <div class="channels" id="channels" role="tablist" aria-label="Channels"></div>
+          <div class="msgs" id="msgs"></div>
+          <div class="typing" id="typing" hidden><span></span><span></span><span></span> Chief is reading</div>
+          <form class="composer" id="composer">
+            <div class="ac" id="ac" hidden></div>
+            <div class="tray" id="tray" hidden></div>
+            <div class="rec" id="rec" hidden><i></i><span id="recText">Recording</span><button type="button" id="recStop" class="link">Stop</button><button type="button" id="recDrop" class="link">Discard</button></div>
+            <textarea id="input" rows="1" placeholder="Message the office · @agent #project" aria-label="Message the office"></textarea>
+            <div class="controls">
+              <button type="button" class="mic" id="mic" title="Record a voice note (hold ⌥M)" aria-label="Record a voice note">
+                <svg viewBox="0 0 24 24"><path d="M12 3a3 3 0 0 1 3 3v5a3 3 0 0 1-6 0V6a3 3 0 0 1 3-3z"/><path d="M5 11a7 7 0 0 0 14 0"/><path d="M12 18v3"/></svg>
+              </button>
+              <button type="button" class="attach" id="attach" title="Attach files or images (or paste / drop them)" aria-label="Attach files">
+                <svg viewBox="0 0 24 24"><path d="M21 11.5l-8.6 8.6a5.5 5.5 0 0 1-7.8-7.8l8.6-8.6a3.7 3.7 0 0 1 5.2 5.2l-8.6 8.6a1.8 1.8 0 0 1-2.6-2.6l7.9-7.9"/></svg>
+              </button>
+              <input type="file" id="file" multiple hidden />
+              <select id="mode" aria-label="Clearance for new work">
+                <option value="plan">Plan only</option>
+                <option value="edit" selected>Edit files</option>
+                <option value="auto">Full autonomy</option>
+              </select>
+              <select id="model" aria-label="Model for new work">
+                <option value="">Chief picks</option>
+                <optgroup label="Fable">
+                  <option value="claude-fable-5-1">Fable 5.1</option>
+                  <option value="claude-fable-5">Fable 5</option>
+                </optgroup>
+                <optgroup label="Opus">
+                  <option value="claude-opus-5-5">Opus 5.5</option>
+                  <option value="claude-opus-5">Opus 5</option>
+                  <option value="claude-opus-4-8">Opus 4.8</option>
+                  <option value="claude-opus-4-7">Opus 4.7</option>
+                  <option value="claude-opus-4-6">Opus 4.6</option>
+                </optgroup>
+                <optgroup label="Sonnet">
+                  <option value="claude-sonnet-5-5">Sonnet 5.5</option>
+                  <option value="claude-sonnet-5">Sonnet 5</option>
+                  <option value="claude-sonnet-4-6">Sonnet 4.6</option>
+                </optgroup>
+                <optgroup label="Haiku">
+                  <option value="claude-haiku-5-5">Haiku 5.5</option>
+                  <option value="claude-haiku-4-5">Haiku 4.5</option>
+                </optgroup>
+              </select>
+              <button class="primary small" type="submit">Send</button>
+            </div>
+          </form>
+        </section>
+        <section class="pane" id="threadPane" hidden>
+          <header class="thread-head">
+            <button type="button" class="link" id="threadBack">← Chat</button>
+            <b id="threadWhere">Thread</b>
+          </header>
+          <div class="msgs" id="threadMsgs"></div>
+          <form class="composer" id="threadComposer">
+            <textarea id="threadInput" rows="1" placeholder="Reply in thread" aria-label="Reply in thread"></textarea>
+            <div class="controls">
+              <button class="primary small" type="submit">Reply</button>
+            </div>
+          </form>
+        </section>
+        <section class="pane" id="teamPane" hidden>
+          <div class="team" id="team"></div>
+        </section>
+        <section class="pane" id="projectsPane" hidden>
+          <div class="projects" id="projects"></div>
+        </section>
+        <section class="pane" id="jobsPane" hidden>
+          <div class="jobs" id="jobs"></div>
+          <button class="ghost" id="clear" hidden>Clear finished</button>
+        </section>
+      </aside>
+      <main class="view" id="view">
+        <div id="stage"></div>
+        <div id="labels"></div>
+        <div class="hud">
+          <div class="chip away" id="away" hidden></div>
+          <div class="chip" id="stats"></div>
+          <div class="chip tools">
+            <button type="button" id="turnLeft" title="Turn left (Q)" aria-label="Turn left">
+              <svg viewBox="0 0 24 24"><path d="M9 7H4V2"/><path d="M4.6 7A9 9 0 1 1 3 13"/></svg>
+            </button>
+            <button type="button" id="turnRight" title="Turn right (E)" aria-label="Turn right">
+              <svg viewBox="0 0 24 24"><path d="M15 7h5V2"/><path d="M19.4 7A9 9 0 1 0 21 13"/></svg>
+            </button>
+            <button type="button" id="recenter" title="Recenter (R)" aria-label="Recenter">
+              <svg viewBox="0 0 24 24"><circle cx="12" cy="12" r="3"/><path d="M12 2v3M12 19v3M2 12h3M19 12h3"/></svg>
+            </button>
+            <button type="button" id="standup" title="Call a standup" aria-label="Call a standup">
+              <svg viewBox="0 0 24 24"><circle cx="12" cy="5" r="2"/><circle cx="5" cy="15" r="2"/><circle cx="19" cy="15" r="2"/><path d="M8.5 20.5a7.5 7.5 0 0 0 7 0M3.5 10.5a8.5 8.5 0 0 1 4.5-5M20.5 10.5a8.5 8.5 0 0 0-4.5-5"/></svg>
+            </button>
+            <button type="button" id="termToggle" title="Terminal (⌃`)" aria-label="Terminal">
+              <svg viewBox="0 0 24 24"><rect x="2.5" y="4" width="19" height="16" rx="2.5"/><path d="M7 9.5l2.6 2.5L7 14.5"/><path d="M12.6 15h4.6"/></svg>
+            </button>
+            <span class="sep"></span>
+            <button type="button" class="sound" id="sound" aria-label="Sound on" title="Sound on"></button>
+            <button type="button" class="sound" id="speak" aria-label="Read replies aloud" title="Read replies aloud"></button>
+          </div>
+        </div>
+        <div class="banner" id="banner"></div>
+        <div class="toast" id="toast"></div>
+        <p class="hint">Drag to move · Right-drag or Q / E to turn · Scroll to zoom · Double-click to go there</p>
+        <section class="term" id="term" hidden aria-label="Terminal">
+          <div class="term-grip" id="termGrip" role="separator" aria-orientation="horizontal" aria-label="Resize the terminal" tabindex="0"></div>
+          <header class="term-bar">
+            <div class="term-tabs" id="termTabs" role="tablist" aria-label="Terminal sessions"></div>
+            <select id="termFolder" aria-label="Folder for the next terminal"></select>
+            <button type="button" class="term-icon" id="termNew" title="New terminal" aria-label="New terminal">
+              <svg viewBox="0 0 24 24"><path d="M12 5v14M5 12h14"/></svg>
+            </button>
+            <span class="term-fill"></span>
+            <span class="term-note" id="termNote"></span>
+            <button type="button" class="term-icon" id="termHide" title="Hide the terminal (⌃`)" aria-label="Hide the terminal">
+              <svg viewBox="0 0 24 24"><path d="M6 18L18 6M6 6l12 12"/></svg>
+            </button>
+          </header>
+          <div class="term-body" id="termBody"></div>
+          <div class="term-off" id="termOff" hidden></div>
+        </section>
+      </main>
+      <aside class="detail" id="detail" hidden></aside>
+      <nav class="mnav" id="mnav" aria-label="Sections">
+        <button type="button" data-m="office" class="on">
+          <svg viewBox="0 0 24 24"><path d="M3 10.5L12 4l9 6.5"/><path d="M5 9.5V20h14V9.5"/><path d="M10 20v-5h4v5"/></svg>Office
+        </button>
+        <button type="button" data-m="chat">
+          <svg viewBox="0 0 24 24"><path d="M4 5h16v11H9l-5 4z"/></svg>Chat<i class="dot" id="mChatDot" hidden></i>
+        </button>
+        <button type="button" data-m="jobs">
+          <svg viewBox="0 0 24 24"><path d="M4 7h16M4 12h16M4 17h10"/></svg>Jobs<b id="mJobCount"></b>
+        </button>
+        <button type="button" data-m="projects">
+          <svg viewBox="0 0 24 24"><path d="M3 7a2 2 0 0 1 2-2h4l2 2h8a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/></svg>Projects
+        </button>
+        <button type="button" data-m="team">
+          <svg viewBox="0 0 24 24"><circle cx="9" cy="8" r="3.2"/><path d="M3 20a6 6 0 0 1 12 0"/><circle cx="17" cy="9" r="2.4"/><path d="M17 14.5a4.6 4.6 0 0 1 4 5.5"/></svg>Team
+        </button>
+      </nav>
+    </div>
+  </body>
+</html>

package/dist/manifest.webmanifest ADDED Viewed

@@ -0,0 +1,16 @@
+{
+  "name": "Agent Office",
+  "short_name": "Office",
+  "description": "Your office of agents, from anywhere.",
+  "start_url": "/",
+  "scope": "/",
+  "display": "standalone",
+  "orientation": "any",
+  "background_color": "#fbf9f5",
+  "theme_color": "#fbf9f5",
+  "icons": [
+    { "src": "/icon-192.png", "sizes": "192x192", "type": "image/png", "purpose": "any" },
+    { "src": "/icon-512.png", "sizes": "512x512", "type": "image/png", "purpose": "any" },
+    { "src": "/icon-512.png", "sizes": "512x512", "type": "image/png", "purpose": "maskable" }
+  ]
+}

package/dist/sw.js ADDED Viewed

@@ -0,0 +1,39 @@
+// Keeps the app shell openable when the connection drops. Live data (/api,
+// the websocket) is never cached: stale office state is worse than none.
+const SHELL = 'office-shell-v1';
+self.addEventListener('install', () => self.skipWaiting());
+self.addEventListener('activate', (e) => {
+  e.waitUntil(
+    caches.keys()
+      .then((keys) => Promise.all(keys.filter((k) => k !== SHELL).map((k) => caches.delete(k))))
+      .then(() => self.clients.claim()),
+  );
+});
+self.addEventListener('fetch', (e) => {
+  const req = e.request;
+  const url = new URL(req.url);
+  if (req.method !== 'GET' || url.origin !== self.location.origin || url.pathname.startsWith('/api')) return;
+  // Hashed build files never change: serve from cache, fill on first sight.
+  if (url.pathname.startsWith('/assets/')) {
+    e.respondWith(caches.open(SHELL).then(async (cache) => {
+      const hit = await cache.match(req);
+      if (hit) return hit;
+      const res = await fetch(req);
+      if (res.ok) cache.put(req, res.clone());
+      return res;
+    }));
+    return;
+  }
+  // The page itself: fresh when online, last copy when not.
+  if (req.mode === 'navigate') {
+    e.respondWith(
+      fetch(req)
+        .then((res) => { if (res.ok) caches.open(SHELL).then((c) => c.put('/', res.clone())); return res; })
+        .catch(() => caches.match('/')),
+    );
+  }
+});

package/docs/README.md ADDED Viewed

@@ -0,0 +1,26 @@
+# Agent Office documentation
+**Guides**
+- [Your first job](guides/your-first-job.md) — from a fresh install to a change you've reviewed
+- [Working with the team](guides/working-with-the-team.md) — briefs that work, clearance, channels, cost
+- [Troubleshooting](guides/troubleshooting.md) — common problems and their fixes
+- [Updating](guides/updating.md) — new versions without losing your office
+**Reference**
+- [Getting started](getting-started.md) — install, run, point it at your projects
+- [Using the office](using-the-office.md) — the chat, channels, threads, standup, the break room
+- [Jobs](jobs.md) — clearance, which model, what changed
+- [The leaderboard](leaderboard.md) — an optional board of jobs, tokens and agent time
+**Setting it up**
+- [Claude access](claude-access.md) — Claude Code login or API key, and the plan meters
+- [Configuration](configuration.md) — every setting
+- [Talking out loud](voice.md) — speech in and voices out, all on this machine
+- [The terminal](terminal.md) — a real shell under the office
+- [On your phone](phone.md) — install it like an app, reach it over Tailscale
+**Under the hood**
+- [How the office works](how-it-works.md) — jobs, agents' office tools, where things are kept
+- [Security](security.md) — who can reach it and what jobs may do
+- [Development](development.md) — dev server, shipping, testing safely
+- [Packaging roadmap](packaging.md) — from a clone to an install

package/docs/claude-access.md ADDED Viewed

@@ -0,0 +1,31 @@
+# Claude access
+The key button beside Appearance chooses how the office signs in to Claude:
+- **Claude Code login** — the login Claude Code keeps on this machine, so jobs
+  run on your Claude plan and the plan meters show how much of it is used.
+- **API key** — an Anthropic API key, billed to that API account. Paste it
+  once; it's checked with Anthropic, kept in `data/auth.json` (readable only by
+  you) and never sent back to the browser. A key already in
+  `ANTHROPIC_API_KEY` is used until you paste another. The plan meters hide,
+  because there's no plan.
+The choice applies to every `claude` the office starts: jobs, the chief,
+standup and break-room talk. With the login chosen, a stray
+`ANTHROPIC_API_KEY` in your shell is kept away from them, since `claude` would
+otherwise prefer it. Jobs already running finish the way they started. The
+in-app terminal is your own shell and never gets the office's key.
+## Plan usage
+Under the level bar, two meters show how much of your Claude plan is used:
+**This session** (the 5-hour window) and **This week**, each with when it
+resets and a countdown. They turn amber at 70% and red at 90%. The server reads
+the same numbers as Claude Code's `/usage`, using the login Claude Code keeps
+on this machine (the macOS keychain, `~/.claude/.credentials.json`, or
+`CLAUDE_CODE_OAUTH_TOKEN`). It checks every two minutes and shortly after each
+turn finishes.
+The meters only apply to the Claude Code login. They use the same endpoint
+Claude Code does, which isn't a published API, so if it stops answering the
+meters say so and the rest of the office carries on.

package/docs/configuration.md ADDED Viewed

@@ -0,0 +1,53 @@
+# Configuration
+Everything is set with environment variables when the server starts, e.g.
+`PORT=4400 CHIEF_MODEL=haiku npm start`. In-app choices — Claude access, the
+voice toggle, team profiles, theme — are made in the office and remembered.
+## The office
+| Env | Default | |
+|---|---|---|
+| `OFFICE_ROOT` | the folder above this one; with `agentoffice`, the folder you run it from | its subfolders are the projects |
+| `OFFICE_DATA` | `data/` here; with `agentoffice`, `~/.agent-office` | where the office keeps its state |
+| `PORT` | `4317` | |
+| `OFFICE_ALLOWED_HOSTS` | none | extra hostnames to accept, comma-separated; see [On your phone](phone.md) |
+## Claude
+| Env | Default | |
+|---|---|---|
+| `CLAUDE_BIN` | `claude` | the Claude Code binary |
+| `ANTHROPIC_API_KEY` | none | used when Claude access is set to *API key* and none was pasted; see [Claude access](claude-access.md) |
+| `CLAUDE_CODE_OAUTH_TOKEN` | none | a Claude Code login token, for the login mode and the plan meters |
+| `CHIEF_MODEL` | `sonnet` | the chief of staff, and the standup write-up |
+| `AGENT_COMPACT_PCT` | `60` | how full an agent's context gets before Claude Code compacts it |
+## Standup and the break room
+| Env | Default | |
+|---|---|---|
+| `STANDUP_AT` | `09:30` | local time, or `off` |
+| `STANDUP_WEEKENDS` | unset | `1` holds standups on weekends too |
+| `BANTER` | on | `off` keeps break-room talk to the canned lines |
+| `BANTER_MODEL` | `haiku` | the model that writes break-room talk |
+| `BANTER_GAP_SECONDS` | `120` | at most one written conversation per this many seconds |
+## Voice
+| Env | Default | |
+|---|---|---|
+| `WHISPER_BIN` | `whisper-cli` | |
+| `WHISPER_MODEL` | the best model in `data/whisper` | point it at a bigger one (`ggml-small.en.bin`) to trade speed for accuracy |
+| `PIPER_BIN` | `data/piper/venv/bin/python` | the voices live in `data/piper/voices` |
+| `FFMPEG_BIN` | `ffmpeg` | |
+## Terminal
+| Env | Default | |
+|---|---|---|
+| `OFFICE_LEADERBOARD_URL` | unset | address of a leaderboard service; see [The leaderboard](leaderboard.md) |
+| `OFFICE_TERMINAL` | unset | `1` opens the in-app terminal |
+| `OFFICE_TERMINAL_SHELL` | your `$SHELL` | |
+| `OFFICE_TERMINAL_MAX` | `4` | sessions at once |
+| `OFFICE_TERMINAL_IDLE_MIN` | `30` | `0` never closes an idle shell |

package/docs/development.md ADDED Viewed

@@ -0,0 +1,76 @@
+# Development
+```bash
+npm install
+npm run dev          # server with --watch on :4317, Vite with hot reload on :5317
+```
+Use <http://localhost:5317> while developing; Vite proxies `/api` and `/ws`
+to the server.
+## Checking a change
+```bash
+npm run build
+npm test
+```
+`npm test` is a smoke test: it starts the office from a temporary copy with
+its own data, against a stand-in `claude`, and checks that it serves the app,
+refuses other sites, runs a job with the right clearance and records what
+changed. It costs no tokens and can't touch an office you're using. CI runs
+it on macOS and Linux for every push and pull request.
+## Shipping a web change
+`npm run build` writes `dist/`, which the server reads from disk on every
+request. A web-only change goes live with a build and a reload — no server
+restart.
+## Shipping a server change
+Server changes need a restart. `npm start` runs the server under a small
+supervisor (`server/supervise.js`) so the office can restart itself:
+- **You:** type `/restart` in the chat (`/restart now` skips the wait).
+- **An agent:** calls its `restart_office` tool, then ends its turn. It gets a
+  message when the office is back, so it can check its change.
+A restart waits until nobody is mid-turn (up to 10 minutes, then it goes
+anyway), exits with code 75, and the supervisor starts a fresh server. Open
+jobs resume on their sessions. Before exiting, the server checks that its own
+code parses and loads, and refuses if it doesn't, because a broken server would
+leave nothing running to fix it. If the server crashes three times in a row
+within seconds of starting, the supervisor gives up.
+A server started with plain `node server/index.js`, or with `npm run dev`, has
+no supervisor and refuses to restart itself. Agents must never kill the server
+by signal: its shutdown ends their own process along with everyone else's.
+## Testing without touching the live office
+A second server pointed at the same `data/` resumes the live office's jobs.
+Test from a copy instead, on another port, with its own data and a scratch
+project folder:
+```bash
+rsync -a --exclude data --exclude dist --exclude .git --exclude node_modules ./ /tmp/office-test/
+ln -s "$PWD/node_modules" /tmp/office-test/node_modules
+cd /tmp/office-test && npx vite build
+PORT=4398 OFFICE_ROOT=/tmp/office-test-projects CLAUDE_BIN=/path/to/stub \
+  STANDUP_AT=off BANTER=off node server/index.js
+```
+`CLAUDE_BIN` can point at a stub that records its arguments and environment,
+so you can check what a job was started with without spending tokens.
+`launch/stub.mjs` is a fuller one that plays scripted jobs.
+When you stop a test server, kill it by PID, not with `pkill -f`, which can't
+tell it from the live one.
+## The launch video
+`launch/` holds the tooling that recorded the launch video: `setup.sh` resets a
+sandbox office on port 4399 under `/tmp/office-demo`, `stub.mjs` plays the
+scripted agents, and the Python scripts drive and capture the browser. The
+rendered video itself isn't kept in git.

package/docs/getting-started.md ADDED Viewed

@@ -0,0 +1,54 @@
+# Getting started
+## What you need
+- **Node.js 20 or newer.**
+- **Claude Code**, installed and on your `PATH` as `claude`. Either sign in
+  once by running `claude` in a terminal, or have an Anthropic API key ready
+  (see [Claude access](claude-access.md)).
+- **macOS or Linux.** Windows works under WSL.
+- **git**, for the "what changed" card on each job.
+## Install and run
+```bash
+git clone https://github.com/onuohasilver/agent-office.git
+cd agent-office
+npm install
+npm start            # builds, then serves on http://localhost:4317
+```
+Open <http://localhost:4317>.
+## Where your projects are
+The office's projects are the subfolders of one folder, `OFFICE_ROOT`. By
+default that is the folder the office itself sits in, so a layout like this
+works with no settings:
+```
+~/code/
+├── agent-office/
+├── storefront/      ← a project
+└── payments-api/    ← a project
+```
+Point it somewhere else with `OFFICE_ROOT=~/work npm start`. Name a project in
+the chat with `#`, e.g. `#storefront`.
+## Optional extras
+| Extra | What it adds | How |
+|---|---|---|
+| Voice | talk to the office, hear it answer | [Talking out loud](voice.md) |
+| Terminal | a real shell in a drawer under the office | [The terminal](terminal.md) |
+| Phone | the office on your phone, installed like an app | [On your phone](phone.md) |
+## Next
+Run [your first job](guides/your-first-job.md).
+## Developing
+`npm run dev` serves with hot reload on <http://localhost:5317>. See
+[Development](development.md).