Getting started

Install

Install the desktop app, launch it, then connect a provider before starting your first project session.

Image ยท 16/10install-flow
slot
fill me

Download and install

Download the current desktop build, then move AgentsOS.app into /Applications.

Since AgentsOS is still in beta and not yet signed with an Apple Developer certificate, you may need to run this after installing:

xattr -cr /Applications/AgentsOS.app

Then launch AgentsOS from Applications.

First launch

On a fresh install, the Projects screen is empty and no provider is selected. Open Settings, connect a provider or external agent, then return to Projects and open a project folder.

Local data

The app stores its local database, logs, provider settings, notes, tasks, sessions, and related app data under the platform app-data directory. On macOS, that is ~/Library/Application Support/AgentsOS.

Uninstall

Delete AgentsOS.app from Applications. To remove local app data too, delete the AgentsOS app-data directory. That removes saved providers, projects, sessions, notes, tasks, usage history, and settings.