@vforsh/argus 0.1.19 → 0.1.20

package/dist/skill/argus/SKILL.md

@@ -47,6 +47,8 @@ Read:
 
 Use this for any app that needs the user's normal browser profile, cookies, local storage, extensions, or saved login state. Do **not** use `argus start`, `argus chrome start --profile temp`, headless Chrome, or a fresh CDP profile for this flow; those lose the real login/session context.
 
+First-time setup is one command: `argus extension install` (installs native hosts, opens chrome://extensions, waits for connect). The extension ID is pinned and the build ships with the CLI — see [EXTENSION.md](./reference/EXTENSION.md).
+
 ```bash
 APP_URL="https://portal.example/app"
 WATCHER_ID="app"
@@ -168,7 +170,7 @@ Keep these commands in the background in agent shells. See [START.md](./referenc
 
 ## Troubleshooting
 
-**No extension-control watcher** — Open/reload the browser extension, then run `argus ext doctor --json`.
+**No extension-control watcher** — First time? Run `argus extension install`. Otherwise open/reload the extension, then run `argus ext doctor --json`.
 
 **Multiple tabs matched** — Use `argus ext tabs --url <url> --json`, choose a `tabId`, then pass `--tab <tabId>`.
 

package/dist/skill/argus/reference/EXTENSION.md

@@ -5,18 +5,23 @@ Debug normal Chrome session without CDP flags.
 ### One-Time Setup
 
 ```bash
-# 1) Build extension
-cd packages/argus-extension && bun run build
+# Installs native hosts, opens chrome://extensions, waits for the extension to connect:
+argus extension install
+#   → click "Load unpacked" and select the printed folder (enable Developer mode if hidden)
+```
 
-# 2) Load in Chrome
-#    chrome://extensions → Developer mode → Load unpacked → select packages/argus-extension
-#    Copy Extension ID (e.g. kkoefnlnjlnlbohcifcbkpgmjaokmipi)
+The extension ID is **pinned** (via a `key` in the manifest), so there's no ID to copy/paste and the prebuilt extension ships with the CLI — no build step. Useful sub-commands:
 
-# 3) Install native host
-argus extension setup <EXTENSION_ID>
-argus extension status
+```bash
+argus extension path      # absolute folder to "Load unpacked"
+argus extension status    # native host config + extension ID
+argus extension install --no-wait   # scripted/non-interactive (skip the connect wait)
 ```
 
+Advanced: `argus extension setup [extensionId]` installs only the native hosts (pass an id to override the pinned one for a differently-keyed build).
+
+> Migration: if you previously loaded an unkeyed build, reload the extension once at `chrome://extensions` so it picks up the pinned ID.
+
 ### Usage
 
 1. Click Argus extension icon

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vforsh/argus",
-	"version": "0.1.19",
+	"version": "0.1.20",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/vforsh/argus.git",
@@ -36,7 +36,7 @@
 	"scripts": {
 		"clean": "node ../../scripts/clean-dist.mjs",
 		"build": "npm run clean && tsc -b && bun run bundle",
-		"bundle": "bun build dist/bin.js --outfile dist/argus.js --target node --external esbuild && node ../../scripts/copy-argus-skill.mjs",
+		"bundle": "bun build dist/bin.js --outfile dist/argus.js --target node --external esbuild && node ../../scripts/copy-argus-skill.mjs && node ../../scripts/copy-argus-extension.mjs",
 		"typecheck": "tsc -b --pretty false",
 		"chrome:start": "bun src/bin.ts chrome start"
 	}