agenter-app 1.0.0 → 1.0.2

package/README.md

@@ -19,6 +19,8 @@ agenter install   # adds hooks to ~/.claude/settings.json (a backup is made) + D
 
 Then **reload each VS Code window** (or start new Claude sessions). Hooks are read when a session starts.
 
+Skipped `agenter install`? Running `agenter` notices the hooks are missing and offers to set them up.
+
 Install it globally (`-g`), not with `npx`: the hooks point at the installed files, so they need to stay put.
 If you move Node (a new Node version manager install, say), run `agenter install` again; it replaces the old hooks.
 

package/cli.js

@@ -1,10 +1,18 @@
 #!/usr/bin/env node
 // The `agenter` command (npm i -g agenter-app). Each subcommand runs one of the existing scripts.
 'use strict';
+const fs = require('node:fs');
+const os = require('node:os');
 const path = require('node:path');
+const readline = require('node:readline/promises');
 const { spawnSync } = require('node:child_process');
 const { version } = require('./package.json');
 
+const CLAUDE_SETTINGS = path.join(os.homedir(), '.claude', 'settings.json');
+// The same path install.js puts in the hook commands.
+const HOOK_SCRIPT = path.join(__dirname, 'hook.js').replace(/\\/g, '/');
+const PROMPT_FILE = path.join(os.homedir(), '.agenter', 'cli.json');
+
 const [cmd = 'open', ...rest] = process.argv.slice(2);
 const isWindows = process.platform === 'win32';
 
@@ -20,11 +28,59 @@ const shortcuts = (args = []) => {
   return spawnSync('powershell.exe', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', ps1, ...args], { stdio: 'inherit' }).status ?? 1;
 };
 
+const install = (args = []) => {
+  const status = node('install.js', args);
+  return status === 0 ? shortcuts() : status;
+};
+
+// 'ok' when this copy's hooks are installed, 'other' when only an older copy's are, else 'missing'.
+const hookState = () => {
+  let commands = [];
+  try {
+    const { hooks = {} } = JSON.parse(fs.readFileSync(CLAUDE_SETTINGS, 'utf8'));
+    commands = Object.values(hooks).flat().flatMap((g) => g?.hooks || []).map((h) => h?.command).filter((c) => typeof c === 'string');
+  } catch {}
+  if (commands.some((c) => c.includes(HOOK_SCRIPT))) return 'ok';
+  return commands.some((c) => /agenter[^"]*\/hook\.js"$/i.test(c)) ? 'other' : 'missing';
+};
+
+// Setup is never run without asking. A "no" is remembered until Agenter moves to a new path.
+async function offerSetup() {
+  const state = hookState();
+  if (state === 'ok') return;
+  try {
+    if (JSON.parse(fs.readFileSync(PROMPT_FILE, 'utf8')).declinedSetup === HOOK_SCRIPT) return;
+  } catch {}
+
+  const [why, ask] =
+    state === 'other'
+      ? ['Your Claude hooks point at another copy of Agenter (an older install, or Node moved).', 'Point them at this one?']
+      : ["Agenter's hooks aren't set up yet, so your Claude sessions won't show up.", 'Set them up now?'];
+  if (!process.stdin.isTTY) {
+    console.log(`${why}\nRun: agenter install`);
+    return;
+  }
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  rl.on('SIGINT', () => process.exit(130));
+  const answer = (await rl.question(`${why}\n${ask} (Y/n) `)).trim().toLowerCase();
+  rl.close();
+
+  if (['', 'y', 'yes'].includes(answer)) {
+    install();
+    return;
+  }
+  fs.mkdirSync(path.dirname(PROMPT_FILE), { recursive: true });
+  fs.writeFileSync(PROMPT_FILE, JSON.stringify({ declinedSetup: HOOK_SCRIPT }, null, 2));
+  console.log("OK. Run 'agenter install' whenever you want them.");
+}
+
 const help = `Agenter ${version}: one inbox for every Claude Code and Codex session.
 
 Usage: agenter [command]
 
-  (none), open     Open the dashboard (starts the server if needed)
+  (none), open     Open the dashboard (starts the server if needed); offers setup
+                   if the hooks aren't installed yet
   install          Add Agenter's hooks to ~/.claude/settings.json (backed up first)
                    and, on Windows, Desktop and Start Menu shortcuts
   uninstall        Remove the hooks and shortcuts
@@ -34,38 +90,40 @@ Usage: agenter [command]
 
 After installing, reload your VS Code windows so Claude sessions pick up the hooks.`;
 
-let status = 0;
-switch (cmd) {
-  case 'open':
-    status = node('open.js', rest);
-    break;
-  case 'install':
-    status = node('install.js', rest);
-    if (status === 0) status = shortcuts();
-    break;
-  case 'uninstall':
-    status = node('install.js', ['--uninstall']);
-    shortcuts(['-Remove']);
-    break;
-  case 'start':
-    status = node('server.js', rest);
-    break;
-  case 'shortcuts':
-    status = shortcuts(rest.includes('--startup') ? ['-Startup'] : []);
-    break;
-  case 'version':
-  case '--version':
-  case '-v':
-    console.log(version);
-    break;
-  case 'help':
-  case '--help':
-  case '-h':
-    console.log(help);
-    break;
-  default:
-    console.error(`Unknown command: ${cmd}\n`);
-    console.log(help);
-    status = 1;
-}
-process.exit(status);
+(async () => {
+  let status = 0;
+  switch (cmd) {
+    case 'open':
+      await offerSetup();
+      status = node('open.js', rest);
+      break;
+    case 'install':
+      status = install(rest);
+      break;
+    case 'uninstall':
+      status = node('install.js', ['--uninstall']);
+      shortcuts(['-Remove']);
+      break;
+    case 'start':
+      status = node('server.js', rest);
+      break;
+    case 'shortcuts':
+      status = shortcuts(rest.includes('--startup') ? ['-Startup'] : []);
+      break;
+    case 'version':
+    case '--version':
+    case '-v':
+      console.log(version);
+      break;
+    case 'help':
+    case '--help':
+    case '-h':
+      console.log(help);
+      break;
+    default:
+      console.error(`Unknown command: ${cmd}\n`);
+      console.log(help);
+      status = 1;
+  }
+  process.exit(status);
+})();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenter-app",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "One local dashboard to watch, approve and steer every Claude Code and Codex session on your machine.",
   "keywords": [
     "claude",
@@ -13,13 +13,13 @@
   ],
   "author": "Ahmad Pandaog Aquino (https://ahmad-new-portfolio.vercel.app/)",
   "license": "MIT",
-  "homepage": "https://github.com/zxcoding123/agenter_app#readme",
+  "homepage": "https://agenterlandingpage.vercel.app/",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/zxcoding123/agenter_app.git"
   },
   "bugs": {
-    "url": "https://github.com/zxcoding123/agenter_app/issues"
+    "url": "https://agenterlandingpage.vercel.app/"
   },
   "bin": {
     "agenter": "cli.js"

package/public/index.html

@@ -4,7 +4,9 @@
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
   <title>Agenter</title>
-  <link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Crect width='32' height='32' rx='8' fill='%23b7d4a6'/%3E%3Cpath d='M16 7l8 9-8 9-8-9z' fill='%23161813'/%3E%3C/svg%3E">
+  <link rel="icon" href="/favicon.ico" sizes="any">
+  <link rel="icon" type="image/png" sizes="256x256" href="/icon.png">
+  <link rel="apple-touch-icon" href="/icon.png">
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700&family=Geist+Mono:wght@400;500;600&display=swap">

package/scripts/install-shortcuts.ps1

@@ -20,7 +20,7 @@ foreach ($t in $targets) {
   $lnk.TargetPath = "$env:SystemRoot\System32\wscript.exe"
   $lnk.Arguments = "`"$root\Agenter.vbs`""
   $lnk.WorkingDirectory = $root
-  $lnk.IconLocation = "$env:SystemRoot\System32\shell32.dll,94"
+  $lnk.IconLocation = "$root\public\agenter.ico,0"
   $lnk.Description = 'Watch and answer all your Claude Code sessions'
   $lnk.Save()
   "Created $t"

package/server.js

@@ -1230,6 +1230,8 @@ const STATIC = {
   '/': ['index.html', 'text/html; charset=utf-8'],
   '/app.js': ['app.js', 'text/javascript; charset=utf-8'],
   '/style.css': ['style.css', 'text/css; charset=utf-8'],
+  '/icon.png': ['icon.png', 'image/png'],
+  '/favicon.ico': ['agenter.ico', 'image/x-icon'],
 };
 
 const ALLOWED_HOSTS = new Set([`127.0.0.1:${PORT}`, `localhost:${PORT}`]);