AgentOS by SapienX

Quickstart

Install AgentOS. Open Mission Control.

Pick the workflow that matches your environment. The home page one-liner now auto-detects Windows versus Unix-like shells; this page keeps the explicit commands and links in one place.

Open repository How it works FAQ

Fastest path (Unix one-liner)

Use the shell installer on macOS or Linux. The home page one-liner will route Windows users to PowerShell.

curl -fsSL https://raw.githubusercontent.com/SapienXai/AgentOS/main/install.sh | bash

agentos start --open agentos doctor

Once AgentOS is installed, use it as the human control surface: create one workspace per project and keep tasks scoped to concrete deliverables.

macOS

The shell installer is the same command used by the Unix one-liner.

curl -fsSL https://raw.githubusercontent.com/SapienXai/AgentOS/main/install.sh | bash

agentos start --open agentos doctor

Linux

The shell installer is the same command used by macOS.

curl -fsSL https://raw.githubusercontent.com/SapienXai/AgentOS/main/install.sh | bash

agentos start --open agentos doctor

Alternate install (pnpm)

Best when you want the documented package workflow for AgentOS.

pnpm add -g @sapienx/agentos

agentos start --open agentos doctor

Windows PowerShell

Use the Windows install path documented in the AgentOS repository README.

iwr https://raw.githubusercontent.com/SapienXai/AgentOS/main/install.ps1 | iex

agentos start --open agentos doctor

If you need a pinned release or uninstall steps, follow the links and details in the repository README.

Builders (website source)

Clone this repository if you want to edit the AgentOS marketing site or extend the page cluster.

git clone https://github.com/SapienXai/AgentOS.git
cd AgentOS
pnpm install
pnpm dev

AgentOS stays aligned with OpenClaw runtime truth. If you are debugging deeper behavior, check the OpenClaw gateway status underneath.

Verify the operating stack

Use the local checks to confirm AgentOS is ready.

Runtime health: run agentos doctor for local checks.
Launch state: open Mission Control with agentos start --open.
First workspace: create a workspace that points to real files and a real deliverable, then assign one task with an explicit output.

Quickstart FAQ

What is the fastest way to install AgentOS?

Use the documented install path that matches your platform. On macOS or Linux, use the installer one-liner; on Windows, use the PowerShell command from the repository README. Then open AgentOS Mission Control locally.

How do I verify the runtime underneath AgentOS?

Start with agentos doctor, then launch Mission Control with agentos start --open. If you need deeper truth about orchestration, check the OpenClaw gateway/session state underneath.

Understand the architecture and choose the right operational surface for your workflow.