@monoes/monomindcli 1.10.31 → 1.10.33

package/.claude/skills/monomind/browse-electron.md

@@ -13,21 +13,20 @@ triggers:
 tools:
   - Bash
 requires:
-  - agent-browser >= 0.25.4
+  - monomind >= 1.0.0
 ---
 
-<!-- Pattern adapted from agent-browser — rebranded for monomind -->
 
 # Electron App Automation (monomind:browse-electron)
 
-Automate any Electron desktop app using agent-browser via Chrome DevTools Protocol (CDP). Electron apps are built on Chromium and expose a CDP port, enabling the same snapshot-interact workflow used for web pages.
+Automate any Electron desktop app using monomind browse via Chrome DevTools Protocol (CDP). Electron apps are built on Chromium and expose a CDP port, enabling the same snapshot-interact workflow used for web pages.
 
 See `monomind:browse` for the full browser automation reference.
 
 ## Core Workflow
 
 1. **Launch** the Electron app with remote debugging enabled
-2. **Connect** agent-browser to the CDP port
+2. **Connect** monomind browse to the CDP port
 3. **Snapshot** to discover interactive elements
 4. **Interact** using element refs
 5. **Re-snapshot** after navigation or state changes
@@ -36,13 +35,13 @@ See `monomind:browse` for the full browser automation reference.
 # Launch an Electron app with remote debugging
 open -a "Slack" --args --remote-debugging-port=9222
 
-# Connect agent-browser to the app
-agent-browser connect 9222
+# Connect monomind browse to the app
+npx monomind browse open --port 0
 
 # Standard workflow from here
-agent-browser snapshot -i
-agent-browser click @e5
-agent-browser screenshot slack-desktop.png
+npx monomind browse snapshot -i
+npx monomind browse click @e5
+npx monomind browse screenshot slack-desktop.png
 ```
 
 ## Launching with CDP
@@ -81,13 +80,13 @@ discord --remote-debugging-port=9224
 
 ```bash
 # Connect to a specific port (persists for session)
-agent-browser connect 9222
+npx monomind browse open --port 0
 
 # Or pass --cdp on each command
-agent-browser --cdp 9222 snapshot -i
+npx monomind browse --cdp 9222 snapshot -i
 
 # Auto-discover a running Chromium-based app
-agent-browser --auto-connect snapshot -i
+npx monomind browse --auto-connect snapshot -i
 ```
 
 ## Tab Management
@@ -95,9 +94,9 @@ agent-browser --auto-connect snapshot -i
 Electron apps often have multiple windows or webviews:
 
 ```bash
-agent-browser tab           # list all targets (windows, webviews)
-agent-browser tab t2        # switch by stable id
-agent-browser tab --url "*settings*"  # switch by URL pattern
+npx monomind browse tab           # list all targets (windows, webviews)
+npx monomind browse tab t2        # switch by stable id
+npx monomind browse tab --url "*settings*"  # switch by URL pattern
 ```
 
 ## Webview Support
@@ -105,14 +104,14 @@ agent-browser tab --url "*settings*"  # switch by URL pattern
 Electron `<webview>` elements appear as separate targets in the tab list:
 
 ```bash
-agent-browser connect 9222
-agent-browser tab
+npx monomind browse open --port 0
+npx monomind browse tab
 # 0: [page]    Slack - Main Window     https://app.slack.com/
 # 1: [webview] Embedded Content        https://example.com/widget
 
-agent-browser tab t2        # switch to webview
-agent-browser snapshot -i
-agent-browser click @e3
+npx monomind browse tab t2        # switch to webview
+npx monomind browse snapshot -i
+npx monomind browse click @e3
 ```
 
 ## Common Patterns
@@ -122,57 +121,57 @@ agent-browser click @e3
 ```bash
 open -a "Slack" --args --remote-debugging-port=9222
 sleep 3
-agent-browser connect 9222
-agent-browser snapshot -i
-agent-browser click @e10
-agent-browser snapshot -i
+npx monomind browse open --port 0
+npx monomind browse snapshot -i
+npx monomind browse click @e10
+npx monomind browse snapshot -i
 ```
 
 ### Screenshots
 
 ```bash
-agent-browser connect 9222
-agent-browser screenshot app-state.png
-agent-browser screenshot --annotate annotated-app.png
+npx monomind browse open --port 0
+npx monomind browse screenshot app-state.png
+npx monomind browse screenshot --annotate annotated-app.png
 ```
 
 ### Extract Data
 
 ```bash
-agent-browser connect 9222
-agent-browser snapshot -i
-agent-browser get text @e5
-agent-browser snapshot --json > app-state.json
+npx monomind browse open --port 0
+npx monomind browse snapshot -i
+npx monomind browse get text @e5
+npx monomind browse snapshot --json > app-state.json
 ```
 
 ### Fill Forms
 
 ```bash
-agent-browser connect 9222
-agent-browser snapshot -i
-agent-browser fill @e3 "search query"
-agent-browser press Enter
-agent-browser wait 1000
-agent-browser snapshot -i
+npx monomind browse open --port 0
+npx monomind browse snapshot -i
+npx monomind browse fill @e3 "search query"
+npx monomind browse press Enter
+npx monomind browse wait 1000
+npx monomind browse snapshot -i
 ```
 
 ### Multiple Apps Simultaneously
 
 ```bash
-agent-browser --session slack connect 9222
-agent-browser --session vscode connect 9223
+npx monomind browse --session slack connect 9222
+npx monomind browse --session vscode connect 9223
 
-agent-browser --session slack snapshot -i
-agent-browser --session vscode snapshot -i
+npx monomind browse --session slack snapshot -i
+npx monomind browse --session vscode snapshot -i
 ```
 
 ## Color Scheme
 
 ```bash
-agent-browser connect 9222
-agent-browser --color-scheme dark snapshot -i
+npx monomind browse open --port 0
+npx monomind browse --color-scheme dark snapshot -i
 # or
-AGENT_BROWSER_COLOR_SCHEME=dark agent-browser connect 9222
+AGENT_BROWSER_COLOR_SCHEME=dark npx monomind browse open --port 0
 ```
 
 ## Troubleshooting
@@ -181,8 +180,8 @@ AGENT_BROWSER_COLOR_SCHEME=dark agent-browser connect 9222
 |---------|-----|
 | "Connection refused" | App not launched with `--remote-debugging-port`, or port mismatch |
 | Connect fails after launch | Wait a few seconds — `sleep 3` before connect |
-| Elements not in snapshot | Use `agent-browser tab` to switch to the right window/webview |
-| Can't type in inputs | Try `agent-browser keyboard type "text"` or `keyboard inserttext "text"` |
+| Elements not in snapshot | Use `monomind browse tab` to switch to the right window/webview |
+| Can't type in inputs | Try `monomind browse keyboard type "text"` or `keyboard inserttext "text"` |
 
 ## Supported Apps
 

package/.claude/skills/monomind/browse-qa.md

@@ -16,10 +16,9 @@ triggers:
 tools:
   - Bash
 requires:
-  - agent-browser >= 0.25.4
+  - monomind >= 1.0.0
 ---
 
-<!-- Pattern adapted from agent-browser — rebranded for monomind -->
 
 # Systematic QA / Dogfood Testing (monomind:browse-qa)
 
@@ -39,7 +38,7 @@ See `monomind:browse` for the full browser automation reference.
 
 Start immediately with defaults. Only ask if authentication is mentioned but credentials are missing.
 
-Always call `agent-browser` directly — never `npx agent-browser`. The direct binary uses the fast Rust client.
+Always call `monomind browse` directly — using `npx monomind browse`. It uses the native TypeScript CDP client.
 
 ## Workflow
 
@@ -57,21 +56,21 @@ Always call `agent-browser` directly — never `npx agent-browser`. The direct b
 ```bash
 mkdir -p ./qa-output/screenshots
 SESSION="$(echo '<TARGET_URL>' | sed 's|https\?://||; s|/.*||; s|\.|-|g')"
-agent-browser --session "$SESSION" open <TARGET_URL>
-agent-browser --session "$SESSION" wait --load networkidle
+npx monomind browse --session "$SESSION" open <TARGET_URL>
+npx monomind browse --session "$SESSION" wait --load networkidle
 ```
 
 ### 2. Authenticate (if needed)
 
 ```bash
-agent-browser --session "$SESSION" snapshot -i
-agent-browser --session "$SESSION" fill @e1 "<EMAIL>"
-agent-browser --session "$SESSION" fill @e2 "<PASSWORD>"
-agent-browser --session "$SESSION" click @e3
-agent-browser --session "$SESSION" wait --load networkidle
+npx monomind browse --session "$SESSION" snapshot -i
+npx monomind browse --session "$SESSION" fill @e1 "<EMAIL>"
+npx monomind browse --session "$SESSION" fill @e2 "<PASSWORD>"
+npx monomind browse --session "$SESSION" click @e3
+npx monomind browse --session "$SESSION" wait --load networkidle
 
 # Save auth state for reuse
-agent-browser --session "$SESSION" state save ./qa-output/auth-state.json
+npx monomind browse --session "$SESSION" state save ./qa-output/auth-state.json
 ```
 
 For OTP/email codes: ask the user, wait for input, then enter the code.
@@ -79,10 +78,10 @@ For OTP/email codes: ask the user, wait for input, then enter the code.
 ### 3. Orient
 
 ```bash
-agent-browser --session "$SESSION" screenshot --annotate ./qa-output/screenshots/00-initial.png
-agent-browser --session "$SESSION" snapshot -i
-agent-browser --session "$SESSION" get title
-agent-browser --session "$SESSION" get url
+npx monomind browse --session "$SESSION" screenshot --annotate ./qa-output/screenshots/00-initial.png
+npx monomind browse --session "$SESSION" snapshot -i
+npx monomind browse --session "$SESSION" get title
+npx monomind browse --session "$SESSION" get url
 ```
 
 Document the starting state: what is visible, main navigation elements, key actions available.
@@ -92,17 +91,17 @@ Document the starting state: what is visible, main navigation elements, key acti
 For each area/page:
 
 ```bash
-agent-browser --session "$SESSION" click @e[nav-item]
-agent-browser --session "$SESSION" wait --load networkidle
-agent-browser --session "$SESSION" snapshot -i
-agent-browser --session "$SESSION" screenshot ./qa-output/screenshots/<page-name>.png
+npx monomind browse --session "$SESSION" click @e[nav-item]
+npx monomind browse --session "$SESSION" wait --load networkidle
+npx monomind browse --session "$SESSION" snapshot -i
+npx monomind browse --session "$SESSION" screenshot ./qa-output/screenshots/<page-name>.png
 ```
 
 **Test systematically:**
 - Navigation: does every link work? Does back/forward work?
 - Forms: submit empty, submit invalid, submit valid
 - Interactive elements: hover states, click states, disabled states
-- Responsive: `agent-browser set viewport 375 812` (mobile), `1280 720` (desktop)
+- Responsive: `monomind browse set viewport 375 812` (mobile), `1280 720` (desktop)
 - Error states: what happens when APIs fail? Use `network route` to simulate failures
 - Loading states: `wait --load networkidle` then check if spinners resolve
 
@@ -112,7 +111,7 @@ For every issue found:
 
 ```bash
 # 1. Screenshot the broken state
-agent-browser --session "$SESSION" screenshot ./qa-output/screenshots/bug-<N>-<name>.png
+npx monomind browse --session "$SESSION" screenshot ./qa-output/screenshots/bug-<N>-<name>.png
 
 # 2. Record reproduction steps in report
 ```
@@ -134,7 +133,7 @@ Issue format:
 ### 6. Wrap Up
 
 ```bash
-agent-browser --session "$SESSION" close
+npx monomind browse --session "$SESSION" close
 ```
 
 Print summary:
@@ -177,12 +176,12 @@ Output:  ./qa-output/
 - [ ] Tooltips appear on hover
 
 **Responsive:**
-- [ ] Mobile (375×812): `agent-browser set viewport 375 812`
-- [ ] Tablet (768×1024): `agent-browser set viewport 768 1024`
-- [ ] Desktop (1280×720): `agent-browser set viewport 1280 720`
+- [ ] Mobile (375×812): `monomind browse set viewport 375 812`
+- [ ] Tablet (768×1024): `monomind browse set viewport 768 1024`
+- [ ] Desktop (1280×720): `monomind browse set viewport 1280 720`
 
 **Error states:**
-- [ ] Network error: `agent-browser network route "https://api.*" --abort`
+- [ ] Network error: `monomind browse network route "https://api.*" --abort`
 - [ ] Empty state: check when lists/tables have no data
 - [ ] 404 page: navigate to `/nonexistent-path`
 
@@ -195,11 +194,11 @@ Output:  ./qa-output/
 
 ```bash
 # Block all API calls to test error handling
-agent-browser batch \
+npx monomind browse batch \
   '["open"]' \
   '["network", "route", "https://api.example.com/*", "--abort"]' \
   '["navigate", "https://app.example.com/dashboard"]'
-agent-browser snapshot -i
+npx monomind browse snapshot -i
 # → Verify error states render correctly
 ```
 
@@ -207,10 +206,10 @@ agent-browser snapshot -i
 
 ```bash
 # Baseline
-agent-browser open https://app.example.com && agent-browser snapshot -i > ./qa-output/baseline.txt
+npx monomind browse open https://app.example.com && monomind browse snapshot -i > ./qa-output/baseline.txt
 
 # After change
-agent-browser open https://app.example.com && agent-browser diff snapshot --baseline ./qa-output/baseline.txt
+npx monomind browse open https://app.example.com && monomind browse diff snapshot --baseline ./qa-output/baseline.txt
 ```
 
 ## Monomind Integration

package/.claude/skills/monomind/browse-references/authentication.md

@@ -1,6 +1,5 @@
 # Authentication Patterns
 
-<!-- Pattern adapted from agent-browser — rebranded for monomind -->
 
 Login flows, session persistence, OAuth, 2FA, and authenticated browsing.
 
@@ -27,13 +26,13 @@ Log in to your target site normally in this Chrome window.
 **Step 2: Save auth state**
 
 ```bash
-agent-browser --auto-connect state save ./my-auth.json
+npx monomind browse --auto-connect state save ./my-auth.json
 ```
 
 **Step 3: Reuse in automation**
 
 ```bash
-agent-browser --state ./my-auth.json open https://app.example.com/dashboard
+npx monomind browse --state ./my-auth.json open https://app.example.com/dashboard
 ```
 
 ## Auth Methods Quick Reference
@@ -51,24 +50,24 @@ agent-browser --state ./my-auth.json open https://app.example.com/dashboard
 ## Basic Login Flow
 
 ```bash
-agent-browser open https://app.example.com/login
-agent-browser snapshot -i
+npx monomind browse open https://app.example.com/login
+npx monomind browse snapshot -i
 # identify: @e[email], @e[password], @e[submit]
-agent-browser fill @e1 "user@test.com"
-agent-browser fill @e2 "SecurePass123!"
-agent-browser click @e3
-agent-browser wait --url "**/dashboard" --timeout 10000
+npx monomind browse fill @e1 "user@test.com"
+npx monomind browse fill @e2 "SecurePass123!"
+npx monomind browse click @e3
+npx monomind browse wait --url "**/dashboard" --timeout 10000
 
 # Save for reuse
-agent-browser state save ./auth.json
+npx monomind browse state save ./auth.json
 ```
 
 ## Session Persistence
 
 ```bash
 # Auto-save/restore state by name
-agent-browser --session-name myapp open https://app.example.com
-# → State saved to ~/.agent-browser/sessions/myapp automatically
+npx monomind browse --session-name myapp open https://app.example.com
+# → State saved to ~/.monomind/browser-sessions/myapp automatically
 # → Next time: just --session-name myapp and you're logged in
 ```
 
@@ -77,7 +76,7 @@ agent-browser --session-name myapp open https://app.example.com
 ```bash
 # Generate a key: openssl rand -hex 32
 export AGENT_BROWSER_ENCRYPTION_KEY=<64-char-hex>
-agent-browser --session-name secure open https://app.example.com
+npx monomind browse --session-name secure open https://app.example.com
 # → State file is AES-256-GCM encrypted at rest
 ```
 
@@ -85,28 +84,28 @@ agent-browser --session-name secure open https://app.example.com
 
 ```bash
 # Store credentials once
-echo "mypassword" | agent-browser auth save github \
+echo "mypassword" | monomind browse auth save github \
   --url https://github.com/login \
   --username me \
   --password-stdin
 
 # Login using stored credentials
-agent-browser auth login github
+npx monomind browse auth login github
 ```
 
 ## Token-Based Auth (Skip Login Form)
 
 ```bash
 # Headers scoped to origin only — never leaked to other domains
-agent-browser open https://api.example.com --headers '{"Authorization": "Bearer <token>"}'
-agent-browser snapshot -i
+npx monomind browse open https://api.example.com --headers '{"Authorization": "Bearer <token>"}'
+npx monomind browse snapshot -i
 ```
 
 ## Cookie Import (from cURL)
 
 ```bash
 # Export from browser DevTools → Network → Copy as cURL → save to file
-agent-browser cookies set --curl ./cookies.curl   # auto-detects format
+npx monomind browse cookies set --curl ./cookies.curl   # auto-detects format
 ```
 
 ## OAuth / SSO
@@ -114,43 +113,43 @@ agent-browser cookies set --curl ./cookies.curl   # auto-detects format
 OAuth flows redirect through external providers — just follow the snapshots:
 
 ```bash
-agent-browser open https://app.example.com/login
-agent-browser snapshot -i
-agent-browser click @e[sign-in-with-google]
-agent-browser wait --url "**/accounts.google.com/**"
-agent-browser snapshot -i
+npx monomind browse open https://app.example.com/login
+npx monomind browse snapshot -i
+npx monomind browse click @e[sign-in-with-google]
+npx monomind browse wait --url "**/accounts.google.com/**"
+npx monomind browse snapshot -i
 # fill Google credentials...
-agent-browser wait --url "**/app.example.com/**"
+npx monomind browse wait --url "**/app.example.com/**"
 # → OAuth complete, save state
-agent-browser state save ./oauth-auth.json
+npx monomind browse state save ./oauth-auth.json
 ```
 
 ## Two-Factor Authentication
 
 ```bash
-agent-browser open https://app.example.com/login
-agent-browser fill @e1 "user@test.com"
-agent-browser fill @e2 "password"
-agent-browser click @e3
-agent-browser wait --text "Enter your code"
+npx monomind browse open https://app.example.com/login
+npx monomind browse fill @e1 "user@test.com"
+npx monomind browse fill @e2 "password"
+npx monomind browse click @e3
+npx monomind browse wait --text "Enter your code"
 
 # Ask user for the 2FA code
 # (pause here, user provides code)
-agent-browser fill @e[otp-field] "<USER_PROVIDED_CODE>"
-agent-browser click @e[verify]
-agent-browser wait --url "**/dashboard"
-agent-browser state save ./2fa-auth.json
+npx monomind browse fill @e[otp-field] "<USER_PROVIDED_CODE>"
+npx monomind browse click @e[verify]
+npx monomind browse wait --url "**/dashboard"
+npx monomind browse state save ./2fa-auth.json
 ```
 
 ## State File Management
 
 ```bash
-agent-browser state save ./auth.json       # save current state
-agent-browser state load ./auth.json       # load into current session
-agent-browser state list                   # list saved state files
-agent-browser state show ./auth.json       # show state summary
-agent-browser state clear                  # clear current session states
-agent-browser state clean --older-than 30  # delete states older than 30 days
+npx monomind browse state save ./auth.json       # save current state
+npx monomind browse state load ./auth.json       # load into current session
+npx monomind browse state list                   # list saved state files
+npx monomind browse state show ./auth.json       # show state summary
+npx monomind browse state clear                  # clear current session states
+npx monomind browse state clean --older-than 30  # delete states older than 30 days
 ```
 
 ## Security Best Practices

package/.claude/skills/monomind/browse-references/trust-boundaries.md

@@ -1,6 +1,5 @@
 # Trust Boundaries
 
-<!-- Pattern adapted from agent-browser — rebranded for monomind -->
 
 Safety rules that apply to every browser automation task. Read before driving a real user's browser session.
 
@@ -28,7 +27,7 @@ Session cookies, bearer tokens, API keys, OAuth codes, and any credentials belon
   "Open DevTools → Network, click any authenticated request,
    right-click → Copy → Copy as cURL, paste into a file, give me the path."
   ```
-  Then: `agent-browser cookies set --curl <file>` — auto-detects JSON / cURL / bare Cookie header. Error messages never echo cookie values.
+  Then: `npx monomind browse cookies set --curl <file>` — auto-detects JSON / cURL / bare Cookie header. Error messages never echo cookie values.
 
 - **Never echo, paste, cat, write, or emit a secret value.** Command strings end up in logs and transcripts. This includes screenshot captions, commit messages, eval scripts, or any file you create.
 

package/.claude/skills/monomind/browse-references/video-recording.md

@@ -1,6 +1,5 @@
 # Video Recording
 
-<!-- Pattern adapted from agent-browser — rebranded for monomind -->
 
 Capture browser automation as video for debugging, documentation, or CI evidence.
 
@@ -9,23 +8,23 @@ Capture browser automation as video for debugging, documentation, or CI evidence
 ## Basic Recording
 
 ```bash
-agent-browser record start ./demo.webm
+npx monomind browse record start ./demo.webm
 
 # Perform actions
-agent-browser open https://example.com
-agent-browser snapshot -i
-agent-browser click @e1
-agent-browser fill @e2 "test input"
+npx monomind browse open https://example.com
+npx monomind browse snapshot -i
+npx monomind browse click @e1
+npx monomind browse fill @e2 "test input"
 
-agent-browser record stop
+npx monomind browse record stop
 ```
 
 ## Commands
 
 ```bash
-agent-browser record start ./output.webm    # start recording to file
-agent-browser record stop                   # stop current recording
-agent-browser record restart ./take2.webm   # stop current + start new
+npx monomind browse record start ./output.webm    # start recording to file
+npx monomind browse record stop                   # stop current recording
+npx monomind browse record restart ./take2.webm   # stop current + start new
 ```
 
 ## Patterns
@@ -33,38 +32,38 @@ agent-browser record restart ./take2.webm   # stop current + start new
 ### Debug a failed automation
 
 ```bash
-agent-browser record start ./debug-$(date +%Y%m%d-%H%M%S).webm
+npx monomind browse record start ./debug-$(date +%Y%m%d-%H%M%S).webm
 
-agent-browser open https://app.example.com
-agent-browser snapshot -i
-agent-browser click @e1 || { echo "Click failed"; agent-browser record stop; exit 1; }
+npx monomind browse open https://app.example.com
+npx monomind browse snapshot -i
+npx monomind browse click @e1 || { echo "Click failed"; monomind browse record stop; exit 1; }
 
-agent-browser record stop
+npx monomind browse record stop
 ```
 
 ### CI/CD test evidence
 
 ```bash
 mkdir -p ./test-recordings
-agent-browser record start ./test-recordings/e2e-$(date +%s).webm
+npx monomind browse record start ./test-recordings/e2e-$(date +%s).webm
 
 # run tests...
 
-agent-browser record stop
+npx monomind browse record stop
 ```
 
 ### Combine with screenshots
 
 ```bash
-agent-browser record start ./flow.webm
+npx monomind browse record start ./flow.webm
 
-agent-browser open https://example.com
-agent-browser screenshot ./screenshots/step1.png
+npx monomind browse open https://example.com
+npx monomind browse screenshot ./screenshots/step1.png
 
-agent-browser click @e1
-agent-browser screenshot ./screenshots/step2.png
+npx monomind browse click @e1
+npx monomind browse screenshot ./screenshots/step2.png
 
-agent-browser record stop
+npx monomind browse record stop
 ```
 
 ## Best Practices
@@ -73,7 +72,7 @@ agent-browser record stop
 2. **Descriptive filenames** — include date/context: `login-flow-2026-05-17.webm`
 3. **Trap cleanup** — always stop recording on exit:
    ```bash
-   cleanup() { agent-browser record stop 2>/dev/null || true; }
+   cleanup() { monomind browse record stop 2>/dev/null || true; }
    trap cleanup EXIT
    ```