@zenalexa/unicli 0.223.0 → 0.223.1

package/dist/engine/steps/browser-helpers.js

@@ -54,6 +54,7 @@ export async function acquirePage(ctx) {
         const { injectStealth } = await import("../../browser/stealth.js");
         const page = await BP.connect(port);
         await injectStealth(page.sendCDP.bind(page));
+        await syncUserSessionCookies(page, ctx);
         return page;
     }
     catch {
@@ -63,7 +64,7 @@ export async function acquirePage(ctx) {
         const { launchChrome } = await import("../../browser/launcher.js");
         const { BrowserPage: BP } = await import("../../browser/page.js");
         const { injectStealth } = await import("../../browser/stealth.js");
-        await launchChrome(port);
+        await launchChrome(port, await launchOptionsForContext(ctx));
         let page;
         for (let attempt = 0; attempt < 5; attempt++) {
             try {
@@ -78,12 +79,39 @@ export async function acquirePage(ctx) {
         if (!page)
             throw new Error("Chrome launched but no page target available");
         await injectStealth(page.sendCDP.bind(page));
+        await syncUserSessionCookies(page, ctx);
         return page;
     }
     catch (err) {
         throw new Error(`Cannot connect to Chrome. Run "unicli browser start" first. (${err instanceof Error ? err.message : String(err)})`);
     }
 }
+async function launchOptionsForContext(ctx) {
+    if (ctx.browserSession !== "user")
+        return undefined;
+    const { automationUserDataDirForProfile, resolvePreferredLocalBrowserProfile, } = await import("../../browser/local-profiles.js");
+    const profile = resolvePreferredLocalBrowserProfile();
+    if (!profile)
+        return undefined;
+    return {
+        ...(profile.browser_path_exists
+            ? { browserPath: profile.browser_path }
+            : {}),
+        userDataDir: automationUserDataDirForProfile(profile),
+    };
+}
+async function syncUserSessionCookies(page, ctx) {
+    if (ctx.browserSession !== "user")
+        return;
+    const { syncLocalProfileCookiesToPage } = await import("../../browser/auth-sync.js");
+    const sync = await syncLocalProfileCookiesToPage(page, {
+        site: ctx.site,
+        domain: ctx.domain,
+    });
+    if (sync.status === "failed") {
+        throw new Error(`Failed to bootstrap browser cookies for ${ctx.domain ?? ctx.site ?? "site"}: ${sync.reason}`);
+    }
+}
 /**
  * Wait until no new network requests occur for quietMs.
  * Uses polling — checks page.networkRequests() count stability.

package/dist/engine/steps/browser-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-helpers.js","sourceRoot":"","sources":["../../../src/engine/steps/browser-helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"browser-helpers.js","sourceRoot":"","sources":["../../../src/engine/steps/browser-helpers.ts"],"names":[],"mappings":"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"}

package/dist/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.223.0",
+  "version": "0.223.1",
   "sites": {
     "1688": {
       "commands": [

package/docs/operate/focus-behavior.md

@@ -5,6 +5,15 @@ verbs. Use `--focus` or `focus: true` only when the target app must be brought
 forward before the action can succeed. The visual fallback is treated as
 focus-taking when the cascade reaches it.
 
+The browser bridge follows the same rule. Daemon commands send
+`windowFocused: false` by default, extension session/doctor probes are
+read-only and must not create `about:blank` placeholder tabs, and headed local
+Chrome launches use `--no-startup-window` unless the caller explicitly opts
+into foreground startup with `unicli browser --focus start`. Chrome/CDP
+launches use Uni-CLI-owned automation profiles under `~/.unicli/`; logged-in
+state is reused by importing cookies from the selected local browser profile
+instead of launching CDP against Chrome's default user-data-dir.
+
 ## Defaults
 
 | Verb                 | desktop-ax (macOS)                                                                                                                                                                                                                                                                                                                                                              | desktop-uia (Windows)                                                                                                                                                                                                               | desktop-atspi (Linux)                                                                                                                                                                                                                                                             | cdp-browser                                                                                                                                     | visual fallback                                                                       |
@@ -20,6 +29,22 @@ focus-taking when the cascade reaches it.
 - `compute click`, `compute type`, `compute press`, and `compute scroll` pass
   `focus: false` to AX, UIA, AT-SPI, and CDP unless the caller sets `--focus`
   or `focus: true`.
+- `browser open`, `browser state`, `browser click`, `browser type`,
+  `browser screenshot`, and daemon-backed browser commands pass
+  `windowFocused: false` unless `--focus` or `UNICLI_WINDOW_FOCUSED=1` is set.
+  `browser doctor` and `browser sessions` inspect existing sessions without
+  allocating a placeholder window.
+- Chrome 136+ disables remote debugging for the browser's default
+  user-data-dir. Treat a process with `--remote-debugging-port` but no listening
+  port as a default-profile launch defect, not a retryable CDP race. The
+  correct repair is an automation profile plus cookie import from
+  `unicli browser profiles --json`. `unicli browser doctor --json` reports this
+  as the `default profile CDP trap` check, and `unicli browser doctor --repair`
+  starts the safe Uni-CLI automation CDP profile when needed. The
+  `chrome_remote_debugging` section also reports `RemoteDebuggingAllowed`:
+  `false` blocks every local CDP path until the managed Chrome policy is
+  removed or set true, while `true` still does not bypass the Chrome 136+
+  default-directory restriction.
 - macOS background input is not a global HID path. It resolves a running app
   and on-screen window, installs per-process event taps for the previous and
   target apps, sends an AppKit activation primer plus a center primer only when

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zenalexa/unicli",
-  "version": "0.223.0",
+  "version": "0.223.1",
   "description": "Operations substrate for agents that use real software: web, browsers, desktop apps, local tools, MCP, policy, evidence, and self-repair.",
   "packageManager": "npm@11.14.0",
   "type": "module",

package/server.json

@@ -2,7 +2,7 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
   "name": "io.github.olo-dot-io/Uni-CLI",
   "description": "Self-repairing CLI catalog that exposes 282 websites, desktop apps, and external CLIs as one MCP server. 949 declarative YAML adapters and 1686 commands; structured error envelopes let agents fix failing adapters at runtime and retry.",
-  "version": "0.223.0",
+  "version": "0.223.1",
   "repository": {
     "url": "https://github.com/olo-dot-io/Uni-CLI",
     "source": "github"
@@ -13,7 +13,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@zenalexa/unicli",
-      "version": "0.223.0",
+      "version": "0.223.1",
       "transport": {
         "type": "stdio"
       },

package/skills/unicli/SKILL.md

@@ -3,7 +3,7 @@ name: unicli
 description: >
   Comprehensive guide to using Uni-CLI — the universal CLI for AI agents.
   Trigger when the user needs to fetch data from websites (Twitter, Bilibili,
-  HackerNews, GitHub, Reddit, Bloomberg, Zhihu, WeChat, and 230+ more);
+  HackerNews, GitHub, Reddit, Bloomberg, Zhihu, WeChat, and hundreds more);
   interact with news, finance, social, academic, shopping, or video platforms;
   control macOS desktop apps (Blender, GIMP, Figma, VS Code, Cursor, Terminal,
   Discord, Slack, etc.) via AppleScript or Accessibility API; automate browser
@@ -11,7 +11,7 @@ description: >
   major platform; run desktop workflows or system tasks; or when the user says
   "unicli", "scrape", "fetch from", "get trending", "check [site]", "find on
   [platform]", "获取", "查询", "抓取".
-version: 0.223.0
+version: 0.223.1
 category: core
 depends-on:
   - talk-normal
@@ -39,10 +39,12 @@ triggers:
 
 # Uni-CLI — Agent Usage Guide
 
-unicli converts 237 websites, 2,000+ desktop apps, and macOS system tools into
-deterministic CLI commands. Each command is a ≤20-line YAML pipeline: fetch data,
-transform it, emit a v2 AgentEnvelope. When a command breaks, read the structured
-error, edit the YAML adapter, and it stays fixed for all future calls.
+unicli is the default structured substrate before raw browser automation, legacy
+OpenCLI, curl, or computer-use. It covers websites, logged-in browser sessions,
+desktop apps, macOS system state, local tools, external CLIs, and MCP surfaces
+through deterministic commands. Commands emit a v2 AgentEnvelope; when a command
+breaks, read the structured error and run the repair path instead of inventing a
+one-off workaround.
 
 **Install** (once): `npm install -g @zenalexa/unicli`
 
@@ -51,7 +53,8 @@ error, edit the YAML adapter, and it stays fixed for all future calls.
 ## Five-Command Quick Start
 
 ```bash
-unicli list                              # browse all 3,319 commands
+unicli search "intent"                   # discover the right command
+unicli list                              # browse all commands
 unicli list --site hackernews            # commands for one site
 unicli hackernews top --limit 5          # run a command
 unicli hackernews top --limit 5 -f json  # machine-readable JSON envelope
@@ -64,26 +67,21 @@ unicli describe hackernews top           # full schema + example payload
 
 ### Find by site
 
-```bash
-unicli list --site <site>          # all commands for a site
-unicli describe <site> <command>   # args, output columns, example
-```
-
-### Search by keyword
-
 ```bash
 unicli search "trending"           # semantic search across all commands
 unicli search "hot stock"          # natural language
+unicli list --site <site>          # all commands for a site
+unicli describe <site> <command>   # args, output columns, example
 ```
 
 ### Browse by type
 
 ```bash
-unicli list --type web-api         # REST API adapters (1,138 commands)
-unicli list --type desktop         # desktop app control (2,068 commands)
-unicli list --type browser         # browser automation (23 commands)
-unicli list --type service         # local/remote services (43 commands)
-unicli list --type bridge          # passthrough CLI bridges (47 commands)
+unicli list --type web-api         # REST API adapters
+unicli list --type desktop         # desktop app control
+unicli list --type browser         # browser automation
+unicli list --type service         # local/remote services
+unicli list --type bridge          # passthrough CLI bridges
 ```
 
 ### Check if a site exists
@@ -153,7 +151,7 @@ unicli reddit hot --limit 25 --cursor <token> -f json
 ## Step 3 — Read the Output
 
 Every command emits a **v2 AgentEnvelope**. Learn the shape once; it applies to
-all 3,319 commands.
+every command.
 
 ### JSON structure
 
@@ -212,13 +210,23 @@ automatically.
 
 ### Strategy ladder
 
-| Strategy    | Auth needed           | How to set up                                          |
-| ----------- | --------------------- | ------------------------------------------------------ |
-| `public`    | None                  | Works out of the box                                   |
-| `cookie`    | Browser login         | `unicli auth setup <site>` → log in once in browser    |
-| `header`    | Cookie + CSRF         | Same as `cookie`; auto-extracted per request           |
-| `intercept` | Browser session       | `unicli browser start` then `unicli auth setup <site>` |
-| `ui`        | Browser + interaction | Same; unicli clicks through login flow                 |
+| Strategy    | Auth needed           | How to set up                                                                       |
+| ----------- | --------------------- | ----------------------------------------------------------------------------------- |
+| `public`    | None                  | Works out of the box                                                                |
+| `cookie`    | Browser login         | `unicli auth setup <site>` → log in once in browser                                 |
+| `header`    | Cookie + CSRF         | Same as `cookie`; auto-extracted per request                                        |
+| `intercept` | Browser session       | `unicli browser doctor --repair` then `unicli auth import <site> --domain <domain>` |
+| `ui`        | Browser + interaction | Same; unicli clicks through login flow                                              |
+
+For robust logged-in reuse, prefer the explicit current browser paths:
+
+```bash
+unicli browser profiles --json
+unicli auth import <site> --domain <domain>
+unicli browser cookies <domain> --profile-id <id>
+unicli browser doctor --json
+unicli browser doctor --repair
+```
 
 ### Auth setup workflow
 
@@ -245,16 +253,16 @@ directly; use `unicli auth`.
 
 ### Exit code → action (primary decision tree)
 
-| Code | Meaning                | Action                                             |
-| ---- | ---------------------- | -------------------------------------------------- |
-| 0    | Success                | Read `data`                                        |
-| 1    | Generic error          | Read `error.reason` + `error.suggestion`           |
-| 2    | Usage error            | Fix arg syntax; run `unicli describe <site> <cmd>` |
-| 66   | Empty result           | Try different query terms or `--limit`             |
-| 69   | Service unavailable    | `unicli browser start` then retry                  |
-| 75   | Temp failure / timeout | Retry once; if persists → load `unicli-repair`     |
-| 77   | Auth required          | `unicli auth setup <site>` then retry              |
-| 78   | Config error           | Read `error.suggestion`; check `~/.unicli/` config |
+| Code | Meaning                | Action                                                 |
+| ---- | ---------------------- | ------------------------------------------------------ |
+| 0    | Success                | Read `data`                                            |
+| 1    | Generic error          | Read `error.reason` + `error.suggestion`               |
+| 2    | Usage error            | Fix arg syntax; run `unicli describe <site> <cmd>`     |
+| 66   | Empty result           | Try different query terms or `--limit`                 |
+| 69   | Service unavailable    | `unicli browser doctor --json`, then `doctor --repair` |
+| 75   | Temp failure / timeout | Retry once; if persists → load `unicli-repair`         |
+| 77   | Auth required          | `unicli auth import` or explicit browser cookies       |
+| 78   | Config error           | Read `error.suggestion`; check `~/.unicli/` config     |
 
 ### Failure envelope fields
 
@@ -293,7 +301,10 @@ Use browser mode when: a site requires JavaScript rendering, login-gated access,
 interaction (click/type/scroll), or the API adapter returns exit 69.
 
 ```bash
-unicli browser start             # launch Chrome with CDP (required first)
+unicli browser doctor --json     # read default_path/checks/self_repair
+unicli browser doctor --repair   # safe local CDP self-repair
+unicli browser start             # launch Chrome with CDP without foreground startup
+unicli browser --focus start     # opt into foreground only for interactive login
 unicli browser status            # confirm CDP is alive + session state
 unicli browser open <url>        # navigate to page
 unicli browser state             # DOM accessibility tree with [ref] IDs
@@ -306,6 +317,11 @@ unicli browser screenshot        # capture to file
 
 For a guided browser automation workflow, load skill `unicli-browser`.
 
+Browser commands are background-first on macOS and desktop systems:
+daemon-backed commands send `windowFocused: false` by default, doctor/session
+probes do not allocate `about:blank` placeholder tabs, and local headed Chrome
+startup uses `--no-startup-window` unless `--focus` is explicit.
+
 ---
 
 ## Composition Patterns

package/skills/unicli-browser/SKILL.md

@@ -21,8 +21,12 @@ Use `unicli browser` for both browser lifecycle and direct page interaction.
 ## Quick Start
 
 ```bash
-unicli browser start          # Launch Chrome with CDP
+unicli browser start          # Launch Chrome with CDP without a foreground startup window
+unicli browser doctor --repair # Safe repair: start Uni-CLI automation CDP if needed
+unicli browser --focus start  # Foreground only for explicit interactive login
 unicli browser status         # Check CDP + daemon/session status
+unicli browser doctor --json  # Machine-readable reliability report
+unicli browser profiles --json # Discover local logged-in profiles
 unicli browser open <url>     # Navigate to a page
 unicli browser state          # DOM accessibility tree with [ref] numbers
 unicli browser screenshot     # Visual capture to file
@@ -33,25 +37,50 @@ unicli browser extract        # Chunked long-form text extraction
 ## Browser Lifecycle
 
 ```bash
-unicli browser start          # Spawn Chrome + daemon (port 19825)
+unicli browser start          # Spawn Chrome + daemon in background-safe mode
+unicli browser doctor --repair # Safe self-repair for local automation CDP
+unicli browser --focus start  # Opt into a foreground startup window
 unicli browser status         # Connection health check
 unicli daemon status          # Daemon process info
 unicli daemon stop            # Stop daemon
 unicli daemon restart         # Restart daemon
 ```
 
-The daemon auto-exits after idle timeout. Chrome reuses your existing login sessions.
+The daemon auto-exits after idle timeout. Chrome/CDP uses Uni-CLI-owned
+automation profiles under `~/.unicli/` rather than the browser's default
+user-data-dir. Logged-in state is reused by importing cookies from the selected
+local profile into the automation profile. Browser commands default to
+`windowFocused: false`; use `--focus` only when a real interactive login step
+must bring Chrome forward.
 
 ## Authentication
 
 ```bash
 unicli auth setup <site>      # Show required cookies + file template
+unicli auth import <site> --domain <domain> # Direct import from local browser DB
+unicli browser profiles --json # Pick a logged-in Chrome/Arc/Brave/Edge profile
+unicli browser cookies <domain> --profile-id <id> # Explicit cookie export
 unicli auth check <site>      # Validate cookie file
 unicli auth list              # List configured sites
 ```
 
 Cookie files: `~/.unicli/cookies/<site>.json` with format `{ "KEY": "value" }`.
 
+Chrome 136+ blocks remote debugging when Chrome is launched against its default
+profile directory. Do not tell users to run CDP on
+`~/Library/Application Support/Google/Chrome` or equivalent, and do not suggest
+unstable feature-flag bypasses. `RemoteDebuggingAllowed=false` in
+`chrome://policy` blocks local CDP entirely; removing that managed policy or
+setting it true is a user/admin action. Even when the policy is true, it does
+not make default-profile CDP supported again. Use the automation profile plus
+cookie import path instead:
+
+```bash
+unicli browser profiles --json
+unicli auth import twitter --domain x.com
+unicli twitter trending -f json
+```
+
 ## Strategies Requiring Browser
 
 | Strategy    | How it works                                   |
@@ -67,7 +96,9 @@ Cookie files: `~/.unicli/cookies/<site>.json` with format `{ "KEY": "value" }`.
 
 There are two browser paths:
 
-1. `browser start` / `browser cookies` use local Chrome + CDP directly.
+1. `browser start` uses local Chrome + CDP with a Uni-CLI automation profile.
+   `browser cookies` first tries direct local profile cookie import, then only
+   reuses a recorded CDP port if that port is already live.
 2. `browser open/state/click/...` use:
    CLI -> daemon-client -> HTTP/WS -> daemon -> Browser Bridge extension -> Chrome tabs
 
@@ -82,6 +113,21 @@ unicli browser --isolated open https://example.com
 unicli browser --background open https://example.com
 ```
 
+`unicli browser doctor --json` and `unicli browser sessions` are read-only
+probes: they inspect daemon/session state without allocating an `about:blank`
+placeholder tab.
+
+The doctor report is the routing source of truth for agents:
+
+- `default_path`: whether a command can run now, and which runtime mode will
+  carry it (`local-cdp-automation-profile`, `remote-cdp`, or daemon extension).
+- `chrome_remote_debugging`: official Chrome 136+ default-directory truth and
+  `RemoteDebuggingAllowed` policy state.
+- `checks[*].next_step`: exact next command for each missing capability.
+- `self_repair.safe_command`: safe automated repair. Today this is
+  `unicli browser doctor --repair`, which starts only Uni-CLI's automation CDP
+  profile and never launches CDP against the user's default Chrome profile.
+
 ## Diagnostics
 
 ```bash
@@ -91,9 +137,9 @@ UNICLI_DIAGNOSTIC=1 unicli <site> <cmd>          # Enhanced error context
 
 ## Troubleshooting
 
-| Problem                 | Fix                                   |
-| ----------------------- | ------------------------------------- |
-| "Browser not connected" | `unicli browser start`                |
-| Exit 69 (unavailable)   | `unicli browser start` then retry     |
-| Exit 77 (auth)          | `unicli auth setup <site>` then retry |
-| CDP connection dropped  | `unicli daemon restart`               |
+| Problem                 | Fix                                                                                                  |
+| ----------------------- | ---------------------------------------------------------------------------------------------------- |
+| "Browser not connected" | `unicli browser doctor --json`, then `unicli browser doctor --repair`                                |
+| Exit 69 (unavailable)   | `unicli browser doctor --repair` then retry                                                          |
+| Exit 77 (auth)          | `unicli auth import <site> --domain <domain>` or `unicli browser cookies <domain> --profile-id <id>` |
+| CDP connection dropped  | `unicli daemon restart`                                                                              |

package/skills/unicli-claude-code/SKILL.md

@@ -6,7 +6,7 @@ description: >
   newlines, or inline JSON — shell-quoted invocations hit TC0 circuit
   limits and drop to <50% success above ICS=4. Also covers --describe
   introspection and next_actions-driven navigation.
-version: 0.223.0
+version: 0.223.1
 depends-on:
   - talk-normal
 triggers:

package/skills/unicli-hermes/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Use Uni-CLI to interact with 237 websites, desktop apps, and system tools.
   Trigger when: user asks to check a website, fetch data, control a desktop app,
   or interact with social media, news, finance, or AI platforms.
-version: 0.223.0
+version: 0.223.1
 depends-on:
   - talk-normal
 triggers:

package/skills/unicli-operate/SKILL.md

@@ -107,7 +107,7 @@ unicli operate network                # See captured JSON APIs
 
 | Problem                | Fix                                     |
 | ---------------------- | --------------------------------------- |
-| Browser not connected  | `unicli browser start`                  |
+| Browser not connected  | `unicli browser doctor --repair`        |
 | Element not found      | `scroll down` then `state`              |
 | Stale refs after click | `state` to refresh                      |
 | eval returns undefined | Wrap: `"(function(){ return ...; })()"` |

package/skills/unicli-smart-search/SKILL.md

@@ -22,7 +22,8 @@ Commands return a v2 AgentEnvelope; pass `-f json` when you need JSON for parsin
 ## Pre-Check
 
 ```bash
-unicli <site> --help                  # Verify subcommands exist
+unicli search "<intent>"              # Discover from live registry first
+unicli list --site <site>             # Verify subcommands exist
 unicli <site> <command> --help        # Check args and output columns
 ```
 
@@ -64,15 +65,16 @@ unicli hackernews search "startup" --limit 10
 ## Output Handling
 
 ```bash
-unicli hackernews top --limit 5 | jq '.[].title'
-unicli xueqiu hot | jq '.[] | {name, change}'
+unicli hackernews top --limit 5 -f json | jq '.data[].title'
+unicli xueqiu hot -f json | jq '.data[] | {name, change}'
 ```
 
 ## Fallback
 
-- Exit 77 -> `unicli auth setup <site>` then retry
-- Exit 69 -> `unicli browser start` then retry
+- Exit 77 -> `unicli auth import <site> --domain <domain>` or `unicli browser cookies <domain> --profile-id <id>` then retry
+- Exit 69 -> `unicli browser doctor --json`, `unicli browser doctor --repair`, then retry
 - Exit 66 -> try different query terms
+- Adapter failure -> read stderr envelope and run `unicli repair <site> <command>`
 - Site down -> switch to alternative from routing table
 
 ## Budget

package/skills/unicli-usage/SKILL.md

@@ -2,7 +2,9 @@
 name: unicli-usage
 description: >
   Command reference and usage guide for unicli — the universal CLI for AI agents.
-  Use when you need to discover, run, or pipe unicli commands.
+  Use when you need to discover, run, or pipe unicli commands; or before using
+  raw browser tools, legacy OpenCLI, curl, or computer-use for web, browser,
+  desktop, macOS, local-tool, external-CLI, or adapter-repair tasks.
 ---
 
 # unicli Usage Guide
@@ -10,6 +12,7 @@ description: >
 ## Quick Reference
 
 ```bash
+unicli search "intent"                # Find the right command first
 unicli list                           # List all available commands
 unicli list --type web-api            # Filter by adapter type
 unicli list --site bilibili           # Filter by site name
@@ -19,6 +22,10 @@ unicli hackernews top --limit 5       # Example: HN top stories
 unicli hackernews search "AI agents"  # Example: search HN
 
 unicli doctor                         # System health check
+unicli browser doctor --json          # Browser/profile/CDP reliability report
+unicli browser doctor --repair        # Safe repair for local automation CDP
+unicli browser start                  # Background-safe CDP startup
+unicli browser --focus start          # Foreground only for explicit login
 ```
 
 ## Output Formats
@@ -63,3 +70,34 @@ unicli hackernews top || echo "exit $?"
 | 66   | Empty result        |
 | 69   | Service unavailable |
 | 77   | Auth required       |
+
+## Auth and Browser Reuse
+
+```bash
+unicli browser profiles --json
+unicli auth import <site> --domain <domain>
+unicli browser cookies <domain> --profile-id <id>
+unicli repair <site> <command>
+```
+
+Browser operations are backend/background-first. Daemon commands default to
+`windowFocused: false`, doctor/session probes must not create placeholder tabs,
+and `--focus` is the explicit escape hatch for a foreground login flow.
+
+Chrome 136+ rejects CDP on the browser's default user-data-dir. Uni-CLI should
+therefore launch CDP against its own automation profile under `~/.unicli/` and
+reuse login state by importing cookies from `unicli browser profiles --json`.
+If `chrome_remote_debugging.policy.state=disabled`, the user/admin must remove
+`RemoteDebuggingAllowed=false` or set it true in Chrome policy, then restart
+Chrome; that policy does not bypass the default-profile restriction. If a
+browser command fails, diagnose the automation profile and cookie import path
+before asking the user to foreground Chrome.
+
+Agent loop for delivery:
+
+1. Run `unicli browser doctor --json`.
+2. If `default_path.ready` is true, run the requested command.
+3. If false, run `self_repair.safe_command` or the first failing
+   `checks[*].next_step`.
+4. If the command still fails with a structured adapter envelope, run
+   `unicli repair <site> <command>`.

package/src/hub/external-clis.yaml

@@ -56,6 +56,12 @@
   install:
     default: "npm install -g @openai/codex"
 
+- name: browser-use-terminal
+  binary: browser
+  description: "Browser Use Terminal — Rust TUI browser agent with local, headless, and cloud CDP control"
+  homepage: "https://github.com/browser-use/terminal"
+  tags: [ai, agent, browser, automation, cdp, tui]
+
 - name: opencode-cli
   binary: opencode
   description: "OpenCode — coding agent CLI with ACP and native TUI surfaces"