Glossary

Term	Definition
Access token	A credential that authenticates the CLI or an external integration with the AskUI Hub. Every token belongs to exactly one workspace and has an expiry date. See Workspaces.
AgentOS	The runtime layer that gives the AI agent direct OS-level control: keyboard, mouse, screen capture, and system functions. Runs on Windows, macOS, and Linux.
Annotation	A marked region around a UI element with metadata including its name, text content, and bounding box coordinates.
Bounding box	A rectangle defined by coordinates that describes the location and size of a UI element on screen.
Companion Mode	An AgentOS control mode where AgentOS runs on an external device (e.g. Raspberry Pi) and controls the target through hardware interfaces. No software installation on the target is required.
Credentials	The combination of a workspace ID and an access token for the same workspace.
Element	A graphical user interface component: a button, text field, menu item, image, etc.
Host Mode	An AgentOS control mode where AgentOS runs directly on the target machine and controls it via OS-level APIs.
Inference	The process of sending a screenshot to the AI model to identify and locate UI elements.
Project	A folder structure created by AskUI Desktop containing tests, prompts, procedures, and plans. The unit of work for authoring and running tests.
Procedure	A reusable multi-step sequence (e.g. "log in") stored in `procedures/` and invoked from test steps by name.
Run report	The output of a test run: a Markdown file with a status and screenshot per step. Statuses are `PASSED`, `FAILED`, `WARN`, `SKIPPED`, or `BROKEN`.
Workspace	The account-level container in the AskUI Hub that owns access tokens, usage events, and billing. Every AskUI account belongs to one or more workspaces.
Workspace ID	The unique identifier for a workspace. Used together with an access token to authenticate with the AskUI Hub.