Agent skill

Unicli Browser

by olo-dot-io in olo-dot-io/Uni-CLI

Control broker-owned hidden, existing-Chrome, or remote browser targets with explicit Agent identity, visibility, profile partitions, and lifecycle.

Apache-2.0Auto-check: notesProductivity & Automation

Install Unicli Browser

skills CLI
$ npx skills add olo-dot-io/Uni-CLI --skill unicli-browser -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install olo-dot-io/Uni-CLI unicli-browser --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/olo-dot-io/Uni-CLI.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/unicli-browser .claude/skills/unicli-browser && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
unicli-browser
GitHub stars
274
Token cost
~1.6k tokens
SKILL.md length
475 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
Apache-2.0

At a glance

Control broker-owned hidden, existing-Chrome, or remote browser targets with explicit Agent identity, visibility, profile partitions, and lifecycle.

  • Works in 5 steps: open the URL. → state to obtain current refs. → Use click, type, select, or keys with… → …
  • Productivity & Automation work in your project
  • SKILL.md covers When to Use, Provider Decision, Quick Start and Agent Sessions and Reuse, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Unicli Browser is an agent skill from olo-dot-io/Uni-CLI. Control broker-owned hidden, existing-Chrome, or remote browser targets with explicit Agent identity, visibility, profile partitions, and lifecycle.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation. It works with Model Context Protocol. The repository describes itself as: One command for every interface—search, run, and inspect real software across APIs, browsers, desktops, local tools, and MCP. The licence is Apache-2.0.

When your agent uses it

  • Productivity & Automation work in your project

Example prompts

  • “/unicli-browser”

Requirements

  • Pre-approved tools (allowed-tools): Bash

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. open the URL.
  2. state to obtain current refs.
  3. Use click, type, select, or keys with those refs.
  4. Run state again after navigation or DOM replacement.
  5. Prefer captured JSON APIs when network reveals a stable endpoint.

What it can do on your machine

Read from SKILL.md and the folder at commit 9316f93. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Unicli Browser loads about 1.6k tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 475 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from olo-dot-io/Uni-CLI at commit 9316f93, republished under its Apache-2.0 licence (© olo-dot-io). 475 words, ~1,581 tokens.

Download SKILL.mdSave it as .claude/skills/unicli-browser/SKILL.md (or your agent's skills folder).
name
unicli-browser
description
Control broker-owned hidden, existing-Chrome, or remote browser targets with explicit Agent identity, visibility, profile partitions, and lifecycle.
allowed-tools
Bash
version
2.0.0
triggers
browser automation, control chrome, unicli browser, background browser
protocol
2

When to Use

Use unicli browser for browser lifecycle, page interaction, session sharing, target handoff, and diagnostics. unicli operate is a compatibility alias for the page-action subset.

Provider Decision

RequirementProvider and visibility
No window; default automationmanaged + hidden (default)
Existing signed-in Chrome tab, no activationchrome + background
Explicit user-visible Chrome interactionchrome + foreground
Explicit cloud/browser serviceremote + hidden

No provider falls back to another. Managed and remote providers cannot become foreground. Existing Chrome cannot promise hidden operation.

Quick Start

bash
unicli browser doctor --json             # Probe only; starts nothing
unicli browser broker start              # Start windowless control plane only
unicli browser start                     # Lazily start default managed hidden target
unicli browser open https://example.com
unicli browser state
unicli browser click <ref>
unicli browser screenshot ./page.png
unicli browser sessions --json

Agent Sessions and Reuse

A stable Agent session owns targets across turns. Different Agent sessions use different targets, while a shared profile partition can reuse login/storage.

bash
unicli browser --session thread-42 --turn turn-1 open https://example.com
unicli browser --session thread-42 --turn turn-2 state
unicli browser --session thread-42 --turn turn-3 click 7
unicli browser sessions --json
unicli browser session-end thread-42

Use --profile-partition team-login to share storage deliberately. Use --isolated for a disposable browser context inside that partition. --workspace is a compatibility spelling for the same partition concept.

Existing Chrome Without Foreground Activation

Install the native host and extension once, keep an existing normal Chrome window open, list tabs, then claim a specific tab:

bash
unicli browser native-host install
unicli browser --provider chrome --visibility background tabs
unicli browser --session thread-42 --provider chrome --visibility background bind 123
unicli browser --session thread-42 --turn turn-2 --provider chrome --visibility background state

Background allocation must preserve focused window and active-tab state. If Chrome cannot satisfy that postcondition, the command fails instead of opening or focusing a window. Use --focus only for an explicit foreground request.

Broker Lifecycle

bash
unicli browser broker status
unicli browser broker start
unicli browser broker restart
unicli browser broker stop

The broker is one authenticated, owner-only local control plane. Starting it does not start Chrome. Browser processes are provider-owned and lazy. Session TTL and target leases are visible through browser status and browser sessions.

Authentication and Profiles

bash
unicli browser profiles --json
unicli browser cookies <domain> --profile-id <id>  # Explicit persistence
unicli auth import <site> --domain <domain>        # Explicit persistence

Managed runtimes use Uni-CLI-owned profiles under ~/.unicli/; they never run CDP against Chrome's default user-data-dir. A selected local profile seeds the automation profile. --ephemeral explicitly selects an empty profile.

Chrome 136+ ignores remote-debugging switches on its default data directory. RemoteDebuggingAllowed=false blocks even Uni-CLI automation profiles until an administrator removes the policy or sets it true. The policy does not make the default-profile CDP path supported.

Show full SKILL.md (179 more words)Show less

Remote Browser

bash
export UNICLI_CDP_ENDPOINT='wss://browser.example/devtools/browser/...'
export UNICLI_CDP_HEADERS='{"Authorization":"Bearer ..."}'
unicli browser remote
unicli browser --provider remote --visibility hidden start

Status redacts credentials, paths, query tokens, and headers. Malformed remote configuration is a hard error and never falls back locally.

Page Workflow

  1. open the URL.
  2. state to obtain current refs.
  3. Use click, type, select, or keys with those refs.
  4. Run state again after navigation or DOM replacement.
  5. Prefer captured JSON APIs when network reveals a stable endpoint.

Useful commands:

bash
unicli browser find --css 'button'
unicli browser query 7 --kind attributes
unicli browser frames
unicli browser console
unicli browser network
unicli browser extract --chunk-size 8000
unicli browser evidence --render-aware

Diagnostics

unicli browser doctor --json is the routing truth:

  • default_path: managed/hidden availability and profile source.
  • broker: stopped, running, or exact endpoint error.
  • providers: managed runtimes, Chrome native-host state, redacted remote state.
  • sessions: live Agent turns, target leases, and tombstones.
  • checks[*].next_step: exact repairs.

unicli browser doctor --repair starts only the broker. It never starts a browser provider and never creates an about:blank placeholder target.

ProblemExact next action
Broker unavailableunicli browser broker restart
Managed browser unavailableInstall Chrome or use explicit --ephemeral
Chrome provider unavailableInstall native host/extension and keep a normal Chrome window open
Remote config invalidCorrect or unset UNICLI_CDP_ENDPOINT / UNICLI_CDP_HEADERS, restart broker
Exit 77Restore auth with explicit profile/cookie flow

© olo-dot-io, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/unicli-browser of olo-dot-io/Uni-CLI.

Open the folder on GitHubat commit 9316f93

Compare with similar skills

Unicli Browser next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Unicli Browser compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Unicli Browser this skillolo-dot-io/Uni-CLI274—~1.6kAutomated safety check: NotesApache-2.0
N8n Docs Assistantn8n-io/n8n207k—~550Automated safety check: PassCustom licence
Planningn8n-io/n8n207k—~2.5kAutomated safety check: PassCustom licence
AgentRQ Workspace Agentagentrq/agentrq1.1k—~1.9kAutomated safety check: PassAGPL-3.0
Suggest Automationsn8n-io/n8n207k—~2kAutomated safety check: PassCustom licence
Webctlcosinusalpha/webctl419—~1.7kAutomated safety check: PassNone

Similar skills

  • Official

    Answers n8n product, setup, credential, node, hosting, API, and usage questions from current n8n docs.

    207k GitHub stars~550 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Planning

    n8n-io/n8n

    Official

    ONLY for coordinated multi-artifact work: multiple workflows with dependencies, shared data-table schema/migration across tasks, or the user explicitly asked to review a plan first.

    207k GitHub stars~2.5k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Guides a workspace agent through executing assigned tasks, replying to a remote human operator, and creating sub-tasks, memory and events inside an AgentRQ workspace.

    1.1k GitHub stars~1.9k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Official

    Offer the three most common automations for a user as a single-choice card, from your own knowledge of their team and their apps, then build the one they choose once they confirm, or offer more.

    207k GitHub stars~2k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Webctl

    cosinusalpha/webctl

    Browser automation via CLI. An agent skill from cosinusalpha/webctl.

    419 GitHub stars~1.7k tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed
  • Huge AI Search

    wangwingzero/huge-ai-search

    Searches the live web through Google AI Mode via Huge AI Search (MCP or CLI).

    144 GitHub stars~563 tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed

More from olo-dot-io/Uni-CLI

All 11 skills in this repo
  • Unicli

    olo-dot-io/Uni-CLI

    Comprehensive guide to Uni-CLI — the open Agent-Computer Interface runtime for real software.

    274 GitHub stars~3.8k tokensUpdated 4 days ago
    Auto-check: notes
  • Unicli Repair

    olo-dot-io/Uni-CLI

    Evidence-driven repair workflow for a broken Uni-CLI adapter.

    274 GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check: notes
  • Unicli Explorer

    olo-dot-io/Uni-CLI

    Create new Uni-CLI adapters by exploring websites and APIs. An agent skill from olo-dot-io/Uni-CLI.

    274 GitHub stars~659 tokensUpdated 4 days ago
    Auto-check: notes
  • Human Writing

    olo-dot-io/Uni-CLI

    通用中文创作与改稿 Skill。用于知乎回答、论坛长帖、公众号文章、博客、评论、人物故事、历史叙事、新闻与行业解读、科普、教程、评测、个人叙事、小说、故事、对白、口播和演讲稿。默认写成一个见过事、查过材料、愿意把来龙去脉讲清楚的人在说话,重点保留中文互联网长回答与长帖的活人感和自然中文韵律,避免空泛的机构腔、喊口号式演说腔、营销腔和模型腔。非虚构长文先检查材料够不够,材料不足时研究、追问或缩短,…

    274 GitHub starsUsed in 2 repos~1.7k tokens
    Auto-check passed
  • Unicli Hermes

    olo-dot-io/Uni-CLI

    Use Uni-CLI to interact with the current website, desktop-app, and system-tool catalog.

    274 GitHub stars~653 tokensUpdated 4 days ago
    Auto-check passed
  • Unicli Smart Search

    olo-dot-io/Uni-CLI

    Route search queries to the best platform via unicli. An agent skill from olo-dot-io/Uni-CLI.

    274 GitHub stars~1.9k tokensUpdated 4 days ago
    Auto-check: notes

Questions about Unicli Browser

What does Unicli Browser do?

Control broker-owned hidden, existing-Chrome, or remote browser targets with explicit Agent identity, visibility, profile partitions, and lifecycle. Unicli Browser is an agent skill from olo-dot-io/Uni-CLI. Control broker-owned hidden, existing-Chrome, or remote browser targets with explicit Agent identity, visibility, profile partitions, and lifecycle.

When should I use Unicli Browser?

Unicli Browser fits situations like: productivity & Automation work in your project.

How do I install Unicli Browser in Claude Code?

Run `npx skills add olo-dot-io/Uni-CLI --skill unicli-browser -a claude-code`. Or copy the skill folder (skills/unicli-browser in olo-dot-io/Uni-CLI) into .claude/skills/unicli-browser in your project. Claude Code loads it when a task matches its description.

How do I install Unicli Browser in Codex?

Run `npx skills add olo-dot-io/Uni-CLI --skill unicli-browser -a codex`. Or copy the skill folder (skills/unicli-browser in olo-dot-io/Uni-CLI) into .agents/skills/unicli-browser in your project. Codex loads it when a task matches its description.

Can I use Unicli Browser in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add olo-dot-io/Uni-CLI --skill unicli-browser -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/unicli-browser, .gemini/skills/unicli-browser, .github/skills/unicli-browser and .opencode/skills/unicli-browser in your project.

What does Unicli Browser need to run?

SKILL.md names no scripts, command-line tools or credentials: Unicli Browser is instructions for the agent only. Its frontmatter pre-approves these tools: Bash.

Does Unicli Browser access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Unicli Browser safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Unicli Browser use?

Unicli Browser is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Unicli Browser use?

About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Unicli Browser?

Skills that share tags, products or a category with Unicli Browser: N8n Docs Assistant (n8n-io/n8n, 207k stars), Planning (n8n-io/n8n, 207k stars), AgentRQ Workspace Agent (agentrq/agentrq, 1.1k stars) and Suggest Automations (n8n-io/n8n, 207k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Unicli Browser?

olo-dot-io (a GitHub organization) maintains it in olo-dot-io/Uni-CLI, which has 274 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 4, 2026.

Source: olo-dot-io/Uni-CLI on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.