openvisio-agent 0.3.0 → 0.3.2

package/bin/cli.mjs

@@ -13,8 +13,8 @@ import { spawnSync } from 'node:child_process'
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
 import { dirname, join } from 'node:path'
-import { parseFlags, slugify, stripSlash, exchangeToken, ensureClaude, writeJson, mcpConfigPath, configPath, chmodSafe, OV_DIR, fail, ok, info } from '../src/lib.mjs'
-import { runWatch } from '../src/watch.mjs'
+import { parseFlags, slugify, stripSlash, exchangeToken, ensureClaude, writeJson, mcpConfigPath, configPath, chmodSafe, onPath, OV_DIR, fail, ok, info } from '../src/lib.mjs'
+import { runWatch, installService } from '../src/watch.mjs'
 
 const HERE = dirname(fileURLToPath(import.meta.url))
 const VERSION = (() => { try { return JSON.parse(readFileSync(join(HERE, '..', 'package.json'), 'utf8')).version } catch { return '0.0.0' } })()
@@ -35,14 +35,19 @@ connect
 
 connect --backend
   Registers a BACKEND agent (created in OpenVisio → Agents → Connect your agent):
-  verifies the api-key + identifier against the org backend, then saves the
-  credentials (~/.openvisio/<agent>.json + a sourceable <agent>.env). The backend
-  dispatches board tasks to the agent; requests authenticate with the
-  x-agent-api-key + x-agent-identifier headers.
+  verifies the api-key + identifier against the org backend, saves the credentials
+  (~/.openvisio/<agent>.json + a sourceable <agent>.env), and — when --ws is given —
+  installs openvisio-agent globally and sets up an ALWAYS-ON background listener
+  (launchd/systemd) that auto-starts on login, so @mentions/assignments are caught
+  even with no terminal open. Requests authenticate with the x-agent-api-key +
+  x-agent-identifier headers.
     --ws <wss-url>   API-Gateway WebSocket base (same as NEXT_PUBLIC_BACKEND_WS_URL)
                      — enables real-time autonomy (task:assigned / agent:mention).
     --mcp-url <url>  registers the openvisio-team MCP so the agent has tools to ACT
                      on those events. Needs Node >= 21 for the WebSocket.
+    --workdir <repo> the always-on listener may do real coding on a branch there.
+    --no-service     skip the background service — just save config + print the
+                     watch commands to run yourself.
 
 watch
   Runs the event-driven autonomy loop (reply to mentions, pick up tickets). Add
@@ -51,6 +56,28 @@ watch
 
 Docs: https://www.npmjs.com/package/openvisio-agent`
 
+// Register the `openvisio-team` MCP at USER (global) scope so it's available in
+// every project without re-adding, and the credentials (baked into the headers)
+// are sent on every call — no per-project prompt. Two gotchas handled here:
+//   1. `claude mcp add` defaults to LOCAL (project) scope — pass `--scope user`.
+//   2. `add` will NOT overwrite an existing same-named server, so a stale entry
+//      (old URL/auth) silently shadows a re-connect ("stuck on the old one").
+//      Remove it from BOTH scopes first, then add global.
+function mcpReplace(claude, addArgs) {
+  spawnSync(claude, ['mcp', 'remove', 'openvisio-team', '-s', 'user'], { stdio: 'ignore' })
+  spawnSync(claude, ['mcp', 'remove', 'openvisio-team', '-s', 'local'], { stdio: 'ignore' })
+  spawnSync(claude, ['mcp', 'add', '--scope', 'user', ...addArgs], { stdio: 'ignore' })
+}
+
+// The persistent `openvisio-agent` command must exist for `watch` (and the
+// background service) to work — an `npx` connect leaves nothing installed. Make
+// the global install part of setup.
+function ensureAgentInstalled() {
+  if (onPath('openvisio-agent')) return
+  info('Installing openvisio-agent globally (so `watch` and the always-on service have a stable command)…')
+  spawnSync('npm', ['i', '-g', 'openvisio-agent@latest'], { stdio: 'inherit', shell: process.platform === 'win32' })
+}
+
 async function runConnect({ positional, flags }) {
   if (flags.backend) return runConnectBackend({ positional, flags })
   const token = positional[0] || flags.token
@@ -67,8 +94,8 @@ async function runConnect({ positional, flags }) {
 
   const claude = ensureClaude()
 
-  // Register with Claude Code (idempotent — ignore "already exists").
-  spawnSync(claude, ['mcp', 'add', '--transport', 'http', 'openvisio-team', mcpUrl, '--header', `Authorization: Bearer ${key}`], { stdio: 'ignore' })
+  // Register with Claude Code — remove any stale entry first so a changed URL sticks.
+  mcpReplace(claude, ['--transport', 'http', 'openvisio-team', mcpUrl, '--header', `Authorization: Bearer ${key}`])
 
   // A scoped MCP config (for the watcher's --strict-mcp-config) + a saved profile.
   const mcpCfg = mcpConfigPath(slug)
@@ -125,7 +152,7 @@ async function runConnectBackend({ flags }) {
     const claude = ensureClaude()
     // Backend agents authenticate with the agent header pair, not a Bearer JWT.
     const hdr = ['--header', `x-agent-api-key: ${apiKey}`, '--header', `x-agent-identifier: ${identifier}`]
-    spawnSync(claude, ['mcp', 'add', '--transport', 'http', 'openvisio-team', mcpUrl, ...hdr], { stdio: 'ignore' })
+    mcpReplace(claude, ['--transport', 'http', 'openvisio-team', mcpUrl, ...hdr])
     mcpConfig = mcpConfigPath(slug)
     writeJson(mcpConfig, { mcpServers: { 'openvisio-team': { type: 'http', url: mcpUrl, headers: { 'x-agent-api-key': apiKey, 'x-agent-identifier': identifier } } } }, true)
   }
@@ -151,18 +178,31 @@ async function runConnectBackend({ flags }) {
   info()
   info('The backend dispatches board tasks assigned to this agent. Every request it')
   info('makes authenticates with the x-agent-api-key + x-agent-identifier headers.')
-  if (wsUrl) {
+  if (!wsUrl) {
+    info()
+    info('Tip: pass --ws <wss-url> and --mcp-url <url> to enable real-time autonomy —')
+    info('     the agent then reacts to task:assigned / agent:mention, always-on.')
+    return
+  }
+
+  // Real-time autonomy IS the point of a backend agent: install the command and a
+  // background service that auto-starts on login, so a mention is always caught —
+  // no terminal left open, survives reboot. Opt out with --no-service.
+  const workdir = flags.workdir === true ? process.cwd() : (flags.workdir ? String(flags.workdir) : '')
+  if (flags['no-service'] || process.platform === 'win32') {
+    ensureAgentInstalled()
     info()
-    info('Real-time autonomy is ready. Let it react to assignments + @mentions live:')
-    info(`  openvisio-agent watch --name ${slug}                    # run now, in this terminal`)
-    info(`  openvisio-agent watch --name ${slug} --install          # background, on login`)
-    info(`  openvisio-agent watch --name ${slug} --workdir <repo>   # allow real coding on a branch`)
-    if (!mcpUrl) info('  (add --mcp-url on connect to give the agent tools to ACT on those events.)')
+    if (process.platform === 'win32') info('Background auto-start isn\'t supported on Windows yet — run the listener yourself:')
+    else info('Real-time autonomy is ready. Start the always-on listener:')
+    info(`  openvisio-agent watch --name ${slug}             # run now, in this terminal`)
+    info(`  openvisio-agent watch --name ${slug} --install   # background, auto-start on login`)
   } else {
     info()
-    info('Tip: pass --ws <wss-url> and --mcp-url <url> to enable real-time autonomy')
-    info('     (the agent reacts to task:assigned / agent:mention over a WebSocket).')
+    info('Setting up the always-on autonomy listener (auto-starts on login, survives reboot)…')
+    installService({ slug, workdir })
+    ok('Your agent is now live — it will catch @mentions and assignments even with no terminal open.')
   }
+  if (!mcpUrl) info('Note: no --mcp-url was given, so the agent hears events but has no tools to reply. Reconnect with --mcp-url to fix.')
 }
 
 async function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openvisio-agent",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Connect your coding agent (Claude Code) to an OpenVisio team — MCP tools + optional autonomy — in one command. No shell scripts.",
   "type": "module",
   "bin": {

package/src/watch.mjs

@@ -234,7 +234,7 @@ function loop({ host, key, claude, mcpConfig, workdir }) {
 }
 
 // ── background service install (launchd / systemd) ───────────────────────────
-function installService({ slug, workdir }) {
+export function installService({ slug, workdir }) {
   const binPath = onPath('openvisio-agent')
   if (!binPath) {
     info('Installing openvisio-agent globally so the background service has a stable path…')