Skip to Content
Referenceoo CLI

oo browser

Use a shared browser with people.

A shared browser is one browser on its own machine that agents and the people an administrator chooses use together; people watch it on its screen in the dashboard, and browse there in tabs of their own. An agent's action takes its turn, and waits while another agent works or a person helps one (browser_person_driving). A person's own action takes no turn: it acts in their own tabs while agents go on. needs-person asks for a person, such as to log in: they help on the screen and press Done, and the agent's turn goes on. done ends an agent's turn and withdraws its ask, or gives the browser back for the person helping; an administrator who manages the browser ends someone else's help with it, as End their help on its page does. Typed text is never logged. create, plan, vm, install and remove set one up and take it down; creating its VM takes the compute permissions, as Create VM in Compute does. access gives an agent access when you manage access, or prints the link where such a person gives it.

oo browser list

The shared browsers you may see

oo browser list

It also takes the connection options.

oo browser show

One browser: its status, who drives, any ask for a person

oo browser show BROWSER_ID
ArgumentRequiredDefaultChoicesDescription
BROWSER_IDyesthe browser's ID, from oo browser list

It also takes the connection options.

oo browser act

One action in the browser

oo browser act [options] BROWSER_ID action
ArgumentRequiredDefaultChoicesDescription
BROWSER_IDyesthe browser's ID, from oo browser list
actionyestabs, open, navigate, snapshot, click, type, press, scroll, screenshot, closetabs lists tabs; open opens one at --page; the rest act on --tab: snapshot it, then click or type by a --ref from the snapshot
--tab TAB_IDnothe tab, from open or tabs
--page PAGEnoan http(s) address, for open and navigate
--ref REFnoan element ref from the latest snapshot, for click and type
--selector SELECTORnoa CSS selector when no ref fits, for click and type
--text TEXTnofor type: the field's new value, or - to read it from standard input
--key KEYnofor press: a key such as Enter, Tab or Escape
--direction DIRECTIONnoup, down, left, rightfor scroll
--amount AMOUNTnofor scroll: pixels, 1 to 10000
--offset OFFSETnofor snapshot: where a long snapshot continues
--full-pagenofor screenshot: the whole page, not just the screen
--out FILEnofor screenshot: write the PNG here instead of printing JSON

It also takes the connection options.

oo browser needs-person

As an agent, ask for a person, such as to log in: prints the link to send them

oo browser needs-person [options] BROWSER_ID reason
ArgumentRequiredDefaultChoicesDescription
BROWSER_IDyesthe browser's ID, from oo browser list
reasonyeswhat the person should do, at most 500 characters
--person PERSONnowho should, by name, if someone in particular

It also takes the connection options.

oo browser done

End your turn and withdraw your ask, or give the browser back after helping (an administrator: end someone's help)

oo browser done BROWSER_ID
ArgumentRequiredDefaultChoicesDescription
BROWSER_IDyesthe browser's ID, from oo browser list

It also takes the connection options.

oo browser people

Print who may use the browser as JSON, as its page lists them: everyone in the Sunport, each with their level on it (manage, control or view, or null) and their own exact grants on it, which oo permissions remove takes away (people); and the agents, each with use, view or null and its grants (agents, null unless you may read the list of agents). It lists everyone, so it needs people.read on everything, with no person denied, besides managing the browser (browsers.manage on it).

oo browser people BROWSER_ID
ArgumentRequiredDefaultChoicesDescription
BROWSER_IDyesthe browser's ID, from oo browser list

It also takes the connection options.

oo browser access

Only a person changes who may use a browser. A person who manages access (access.manage) gives it at once with their own key, and Clem does for the administrator who asked it in chat. Anyone else gets the link to the browser's page in the dashboard, where such a person checks the agent and its access and confirms: send them the link.

oo browser access [options] BROWSER_ID
ArgumentRequiredDefaultChoicesDescription
BROWSER_IDyesthe browser's ID, from oo browser list
--agent AGENT_IDyesthe agent to give access, as oo agents list names it
--level LEVELnouseuse, viewuse drives the browser, taking turns with other agents (the default); view only sees it

It also takes the connection options.

oo browser create

Plan a new shared browser's VM. Create it with oo browser vm, or with Create VM on the browser's page in the dashboard, whose link this prints. Once the VM is made, oo browser install installs the browser, or the page does. On OpenOrange capacity the VM has no public IP unless --public-ip.

oo browser create [options] name
ArgumentRequiredDefaultChoicesDescription
nameyesthe browser's name, at most 60 characters
--size SIZEyesthe VM's size, as oo vm inventory lists it
--provider PROVIDERnoincusincus (OpenOrange capacity, the default), or another provider oo vm inventory lists with Sunport access
--region REGIONnothe region: required off OpenOrange capacity, which picks a node with room
--public-ipnoon OpenOrange capacity, a VM with a public IP

It also takes the connection options.

oo browser plan

Plan its VM again, when the last plan failed or expired

oo browser plan BROWSER_ID
ArgumentRequiredDefaultChoicesDescription
BROWSER_IDyesthe browser's ID, from oo browser list

It also takes the connection options.

oo browser vm

Create the browser's planned VM, as Create VM on its page does: whoever manages the browser (browsers.manage) and holds the compute permissions (hosts.manage and jobs.create) may, an agent's key or an administrator's. Clem does it as the administrator who asked it in chat, when one did.

oo browser vm BROWSER_ID
ArgumentRequiredDefaultChoicesDescription
BROWSER_IDyesthe browser's ID, from oo browser list

It also takes the connection options.

oo browser install

Install the browser on its new VM, or again to repair it

oo browser install BROWSER_ID
ArgumentRequiredDefaultChoicesDescription
BROWSER_IDyesthe browser's ID, from oo browser list

It also takes the connection options.

oo browser remove

Remove a browser and its VM, with its logins and downloads

oo browser remove [options] BROWSER_ID
ArgumentRequiredDefaultChoicesDescription
BROWSER_IDyesthe browser's ID, from oo browser list
--yesnoconfirm it now; an agent passes it only once the person confirmed it in chat

It also takes the connection options.

On this page