Guides

Step-by-step help for setting up AgentOS and using it from your phone.

• 01Install AgentOSInstall AgentOS on macOS or Linux, get through the first-run setup, sign in your agent CLIs, keep it running, and reach it from other devices.Read the guide
• 02Using AgentOS from your phoneAdd your machine to the AgentOS iPhone app, pair it, reach it from anywhere with Connect, and turn on notifications.Read the guide
• 03Sessions and the sidebarStart a session or a task from a draft, find your way around the sidebar, and see what each session is doing and how loaded the machine is.Read the guide
• 04ChatTalk to your agents in a streaming chat with steps, diffs, plans and attachments, or hand the conversation to the agent's own terminal.Read the guide
• 05TasksHand work to an agent that ends in a pull request: queued tasks, sign-off and merge, stacked cards, and plans split into pieces.Read the guide
• 06Schedules and recipesStart agent work on a timer, check in on a session, and save a job that comes up again as a recipe.Read the guide
• 07Agent networkLet sessions find and message each other with the aos command, start work for each other, and follow every conversation in Messages.Read the guide
• 08Sharing a chat or a pageShare a chat or a page as a read-only snapshot link with redaction first, or download it as an HTML file.Read the guide
• 09Local modelsRun a model you host yourself (llama.cpp, vLLM, Ollama, LM Studio) in an AgentOS chat through Pi or OpenCode, with tool calling turned on.Read the guide
• 10ExportExport a whole chat or a range of turns as Markdown, JSON or HTML for another AI to read, compact or full, with secrets masked.Read the guide
• 11Tips and What's NewLearn one AgentOS feature a day from the lightbulb in the sidebar, see what changed in each update, and turn the tips off.Read the guide
• 12Getting aroundPick up each chat where you left it, go back and forward between chats, and what is new since you were last there.Read the guide
• 13Can't reach your machineWhen your phone or another computer can't reach AgentOS, run one check that names the cause, then apply the one-line fix for it.Read the guide