OSagent

The local-first AI agent for your operating system. Built by Locai Labs.

It runs entirely on your machine by default — no cloud services, no API keys, no data leaves your computer. Plug in a hosted provider only when you choose to. The CLI ships with built-in tools (read_file, write_file, bash, web search), persistent memory across sessions, and a skills system the agent extends as it learns.

Get Started →View on GitHub

Quick Links

Topic	What it covers
🚀 Installation	Install in 60 seconds on macOS, Linux, or Windows
📖 What is OSagent?	The 5-minute introduction
🧩 Tools	Built-in tools and how the agent uses them
📚 Skills	On-demand knowledge the agent creates and reuses
🧠 Memory	How OSagent remembers across sessions
🌐 Providers	Local llama-server, OpenAI, Anthropic, and OpenAI-compatible endpoints
⚙️ Configuration	Config file, models, search providers, agent settings
🔒 Sandbox & Safety	Seatbelt on macOS, bubblewrap on Linux, hook-level safety checks
💻 macOS Desktop App	Native SwiftUI app with floating overlay and global hotkey (coming soon)
🛠️ CLI Reference	All flags and REPL commands
🏗️ Architecture	How the pieces fit together
🧰 Build with the Framework	Embed the agent loop in your own TypeScript app
🗺️ Roadmap	What's shipping next
💬 Community	Discord, GitHub, contributing
❓ Troubleshooting	Common issues and how to fix them

Key Features

• Local by default — Downloads and runs open-weight GGUF models via llama.cpp. Your prompts and code stay on your machine unless you explicitly route to a cloud provider.
• Real tools, real safety — Read, write, and patch files. Run shell commands. Search the web. Fetch pages. bash runs inside an OS sandbox (Seatbelt on macOS, bubblewrap on Linux) and hook-level checks catch dangerous patterns even when the sandbox is off.
• Persistent memory — ~/.osagent/memory/USER.md and MEMORY.md are plain markdown files you can read and edit. The agent reads and updates them through the memory tool.
• Skills system — Procedural knowledge the agent creates after solving a task and reuses next time. Skills live in ~/.osagent/skills/ as portable markdown files.
• Bring your own model — Drop any .gguf into ~/.osagent/.models/, or point at any OpenAI-compatible endpoint (Ollama, vLLM, OpenAI, Anthropic, hosted gateways).
• Cross-platform — CLI for macOS, Linux, and Windows. Native SwiftUI desktop app for macOS and a Tauri desktop for Windows and Linux are on the roadmap.
• Developer framework — @locailabs/agent-framework is a standalone TypeScript library: pluggable model clients, custom tools, hooks, streaming, multi-turn conversations.
• Apache 2.0 — Inspect, fork, ship. Source on GitHub.

Install

macOS / Linux

curl -fsSL https://cli.osagent.computer/install.sh | sh

Windows (PowerShell)

irm https://cli.osagent.computer/install.ps1 | iex

The installer downloads the CLI, installs llama-server if missing, adds everything to your PATH, and launches the setup wizard. See Getting Started for the full walkthrough.

For LLMs and coding agents

Machine-readable entry points to these docs:

• /llms.txt — curated index of every doc page with short descriptions. ~5 KB, safe to load into an LLM context.
• /llms-full.txt — every doc page concatenated into one markdown file for one-shot ingestion. ~64 KB.

Generated fresh on every deploy. Follows the llmstxt.org format.