Computer Overview

Beta

Operating software rather than explaining how to operate it.

Most real workflows still live behind interfaces that expose no usable API. The computer layer lets Pimsy drive those interfaces directly — carefully, observably and under policy.

Capability tiers#

Tier	Surface	Scope	Risk
Headless browser	DOM, network, page state	`computer.browser`	Moderate
Visual browser	Rendered page + screenshots	`computer.browser`	Moderate
Desktop control	Full GUI, arbitrary applications	`computer.gui`	High
File operations	Sandbox filesystem	`files.*`	Low
Execution	Shells, runtimes, notebooks	`code.execute`	Moderate

Prefer the narrowest tier that can finish the task. If an API exists, a connector is faster, cheaper and far more reliable than clicking through a UI.

Decision order#

is there an API?          ──yes──▶ connector / tool
        │ no
        ▼
is the page static HTML?  ──yes──▶ fetch + extract
        │ no
        ▼
is it a web app?          ──yes──▶ headless browser (DOM-first)
        │ no
        ▼
is it a desktop app?      ──yes──▶ GUI control (approval required)
        │ no
        ▼
report that the task is not automatable

Last updated 2026-09-09