Use the GetRun Harness App

Install the App, connect your account, and use workspaces, models, sessions, automation, and plugins.

1. Download and install

Get the package for your operating system and architecture from the GetRun download page.

Platform	Package	Installation
macOS	Apple silicon / Intel DMG	Open the DMG and drag the App to Applications
Windows	x64 installer	Run the installer and follow the prompts
Linux	x64 DEB / RPM	Choose the package for your distribution and install it

Before updating, stop active tasks and quit the App, then install the new version.

Choose one method:

Account sign-in: sign in to GetRun and select an API Key.
Enter a Key manually: create a Key on the API Keys page, paste it into the App, and select Save and start.

After connecting, the App opens the home page.

A workspace is the project directory the Agent can access. Session history is stored in its workspace.

Add or select a directory in the workspace area.
Select New Session.
Confirm the file permission scope and model below the message box.
Describe the task and send it. You can inspect tool calls and results or stop a running task.

The model picker lists the GetRun models available to the current Key. If a model is unavailable in an older session, select another model.

A run mode determines the tools available to the Agent. Check the run mode and workspace permissions before starting.

Enable Browser Use or Computer Use under Settings → Automation:

Browser Use uses a separate browser environment by default. Enable the corresponding option to connect your current Chrome session.
Computer Use requests permissions such as Accessibility and Screen Recording when required by the operating system.
Follow the confirmation prompts for navigation, clicks, typing, file uploads, and application launches.

Open Plugin marketplace in App settings, or select Open in App on a GetRun plugin page.
Search for a plugin and review its name, publisher, version, and source.
Select Install and confirm.
Manage or remove plugins under Installed.
Restart the App when prompted.

Select Sign out under Settings → Account and confirm. The App returns to sign-in; workspace files and session history remain.

Symptom	Action
Invalid Key or no models	Enter the Key again and check model access and quota
App does not start	Fully quit the App and open it again
Saved session has no model	Select an available model in that session
Automation is unavailable	Check automation settings, permissions, and helper state
Plugin installation fails	Check the network and retry

For other clients, see Using an API Key.