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 listIt also takes the connection options.
oo browser show
One browser: its status, who drives, any ask for a person
oo browser show BROWSER_ID| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
BROWSER_ID | yes | the 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| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
BROWSER_ID | yes | the browser's ID, from oo browser list | ||
action | yes | tabs, open, navigate, snapshot, click, type, press, scroll, screenshot, close | tabs 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_ID | no | the tab, from open or tabs | ||
--page PAGE | no | an http(s) address, for open and navigate | ||
--ref REF | no | an element ref from the latest snapshot, for click and type | ||
--selector SELECTOR | no | a CSS selector when no ref fits, for click and type | ||
--text TEXT | no | for type: the field's new value, or - to read it from standard input | ||
--key KEY | no | for press: a key such as Enter, Tab or Escape | ||
--direction DIRECTION | no | up, down, left, right | for scroll | |
--amount AMOUNT | no | for scroll: pixels, 1 to 10000 | ||
--offset OFFSET | no | for snapshot: where a long snapshot continues | ||
--full-page | no | for screenshot: the whole page, not just the screen | ||
--out FILE | no | for 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| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
BROWSER_ID | yes | the browser's ID, from oo browser list | ||
reason | yes | what the person should do, at most 500 characters | ||
--person PERSON | no | who 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| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
BROWSER_ID | yes | the 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| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
BROWSER_ID | yes | the 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| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
BROWSER_ID | yes | the browser's ID, from oo browser list | ||
--agent AGENT_ID | yes | the agent to give access, as oo agents list names it | ||
--level LEVEL | no | use | use, view | use 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| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
name | yes | the browser's name, at most 60 characters | ||
--size SIZE | yes | the VM's size, as oo vm inventory lists it | ||
--provider PROVIDER | no | incus | incus (OpenOrange capacity, the default), or another provider oo vm inventory lists with Sunport access | |
--region REGION | no | the region: required off OpenOrange capacity, which picks a node with room | ||
--public-ip | no | on 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| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
BROWSER_ID | yes | the 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| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
BROWSER_ID | yes | the 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| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
BROWSER_ID | yes | the 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| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
BROWSER_ID | yes | the browser's ID, from oo browser list | ||
--yes | no | confirm it now; an agent passes it only once the person confirmed it in chat |
It also takes the connection options.