# AgentOS Documentation > AgentOS is a local-first AI agent runtime: install it, wire up a model provider, and drive it from the terminal, Web UI, macOS desktop app, or chat channels. AgentOS DEX adds token swaps for agents: a keyless HTTP API that returns unsigned calldata, and the on-chain contracts that execute it. Every page below is plain Markdown. Append `.md` to any /docs URL, or send `Accept: text/markdown`, to get the Markdown version. The full set in one file: https://useagentos.dev/llms-full.txt ## AgentOS Core: Getting started - [Quickstart](https://useagentos.dev/docs/core/quickstart.md): This guide gets AgentOS installed, configured, and running locally. It assumes you want the standard product experience: terminal commands, local Web UI… - [Use Cases and Recipes](https://useagentos.dev/docs/core/use-cases.md): Use this page when you know what you want AgentOS to do, but you are not sure which feature guide to read first. - [Gateway](https://useagentos.dev/docs/core/gateway.md): The AgentOS gateway is the local server behind the Web UI, channels, RPC clients, sessions, approvals, diagnostics, and usage views. - [Configuration](https://useagentos.dev/docs/core/configuration.md): AgentOS can be configured from the onboarding wizard, the Web UI setup flow, CLI commands, environment variables, and TOML files. - [CLI Reference](https://useagentos.dev/docs/core/cli.md): The agentos CLI is the fastest way to configure, run, inspect, and automate AgentOS. - [Web UI](https://useagentos.dev/docs/core/web-ui.md): The AgentOS Web UI is the local control console for setup, chat sessions, approvals, channels, logs, agents, usage, and operational status. - [Desktop App (macOS)](https://useagentos.dev/docs/core/desktop-app.md): AgentOS App is the native desktop app for macOS 13 or newer, on Apple silicon and Intel. It installs the engine for you, starts and supervises the local… - [Sessions and History](https://useagentos.dev/docs/core/sessions.md): Sessions are durable AgentOS conversations. They let you inspect past work, resume a conversation, export a transcript, or stop a turn that is still running. - [Glossary](https://useagentos.dev/docs/core/glossary.md): This glossary defines common AgentOS terms in user-facing language. It is not a runtime design document. ## AgentOS Core: Feature guides - [Feature Catalog](https://useagentos.dev/docs/core/features.md): AgentOS combines a personal-agent runtime with model routing, tools, memory, channels, scheduling, and reusable skills. - [Agentic Trading](https://useagentos.dev/docs/core/features/agentic-trading.md): AgentOS treats trading as a first-class capability. Market research, portfolio analysis, and order execution reach the agent through partner-authorized… - [Wallets and Trading](https://useagentos.dev/docs/core/features/trading.md): AgentOS can hold EVM wallets of its own and swap tokens on Base and Robinhood Chain through a pluggable swap provider: the AgentOS Aggregator (default, no… - [LP cards](https://useagentos.dev/docs/core/lp-cards.md): Uniswap V4 liquidity read-outs rendered as cards in the chat transcript. The engine produces the payload (agentos trade lp …), the transcript renders it… - [LP writes](https://useagentos.dev/docs/core/lp-write.md): Phase 1 (docs/lp-cards.md) reads Uniswap V4 liquidity. Phase 2 lets the desk act on it — collect fees, remove liquidity, add liquidity — through the same… - [The liquidity book (trading.lp.book)](https://useagentos.dev/docs/core/lp-book.md): Every liquidity position the engine's wallets hold, across protocols, the way a wallet tracker lists DeFi positions. - [Bridge](https://useagentos.dev/docs/core/bridge.md): The trading engine moves ETH and the USD stable between its two chains through Relay — a public, keyless REST API that prices a cross-chain transfer and… - [DCA mandates](https://useagentos.dev/docs/core/dca.md): A DCA mandate is a recurring buy the trading engine owns and runs by itself: buy $10 of ETH with USDC on Base every day until $300 is spent. - [Price triggers](https://useagentos.dev/docs/core/triggers.md): A trigger is a conditional order the trading engine watches and fires by itself: sell half my ETH if it drops under $3,800, buy $50 of ETH when it is back… - [Brackets](https://useagentos.dev/docs/core/brackets.md): A bracket protects a position with two price triggers at once: sell my ETH when it is up 20 %, or when it is down 10 %, whichever comes first. - [Stock Token markets](https://useagentos.dev/docs/core/markets.md): Which tokens trade against NVDA? On Robinhood Chain a Stock Token is not only something you buy: it is the quote asset for hundreds of other tokens. - [Pilot Router](https://useagentos.dev/docs/core/features/pilot-router.md): Pilot Router is AgentOS's local model-routing layer. It helps the agent choose an appropriate model tier for each turn so routine work does not always run on… - [Tool Compression](https://useagentos.dev/docs/core/features/tool-compression.md): AgentOS agents use tools. Tool calls can produce large outputs: command logs, JSON, web pages, search results, diffs, file contents, tables, and artifacts. - [Memory](https://useagentos.dev/docs/core/features/memory.md): AgentOS memory helps the agent recall durable context without replaying every old conversation. Use it for stable preferences, reusable project facts… - [Skills](https://useagentos.dev/docs/core/features/skills.md): Skills are task-specific instruction packages and scripts. They let AgentOS load relevant guidance only when a task needs it, instead of putting every… - [Browser automation](https://useagentos.dev/docs/core/features/browser.md): The browser tool lets the agent drive a real Chromium — navigate, read a page as an accessibility snapshot with element refs, click, type, fill forms, wait… - [Image Flows](https://useagentos.dev/docs/core/flows.md): An Image Flow is a small node graph that makes images: a prompt goes in, optionally a prompt writer or an image description in between, one or more image… - [ACP Coding Harnesses](https://useagentos.dev/docs/core/acp-agents.md): AgentOS can hand coding work to an external coding agent (Claude Code, Codex, Gemini CLI, Cursor, GitHub Copilot, OpenCode and 20 more) and get the result… - [Compaction and Cache Continuity](https://useagentos.dev/docs/core/features/compaction-and-cache.md): Long agent sessions need context management. AgentOS uses compaction, bounded history, tool-result projection, and cache-aware prompt placement to keep… ## AgentOS Core: Surfaces & operations - [Channels](https://useagentos.dev/docs/core/channels.md): Channels let AgentOS run from messaging platforms while sharing the same agent runtime as the CLI and Web UI. - [Providers and Models](https://useagentos.dev/docs/core/providers-and-models.md): AgentOS supports multiple LLM providers through one configuration surface. You can run direct single-model mode or enable Pilot Router for tiered routing. - [Web Search](https://useagentos.dev/docs/core/search.md): AgentOS can search the web through configured search providers and can fetch pages through guarded web tools. - [X (Twitter) Search](https://useagentos.dev/docs/core/x-search.md): The x search tool searches X posts, profiles, and threads. It is backed by xAI's server-side x search tool on the Responses API at… - [Artifacts and Media](https://useagentos.dev/docs/core/artifacts-and-media.md): AgentOS can create and deliver files as part of agent work: reports, HTML files, PDFs, slide decks, spreadsheets, generated images, and other artifacts. - [Tools, Approvals, and Sandbox](https://useagentos.dev/docs/core/tools-and-sandbox.md): AgentOS tools give the agent useful capabilities. Policy layers, approval surfaces, workspace constraints, and sandbox posture control how those tools are… - [Approvals and Permissions](https://useagentos.dev/docs/core/approvals-and-permissions.md): Approvals and permissions control how AgentOS tools are allowed to act. They matter most when an agent can write files, run shell commands, publish artifacts… - [Durable Agents](https://useagentos.dev/docs/core/agents.md): AgentOS agents are named runtime profiles. Use them when different work streams need different defaults, such as a research workspace, a writing workspace, or… - [Scheduling](https://useagentos.dev/docs/core/scheduling.md): AgentOS scheduling lets you run recurring or one-time agent work from the gateway. Use it for reminders, periodic summaries, status checks, channel updates… - [HTTP API](https://useagentos.dev/docs/core/http-api.md): The AgentOS gateway is a Starlette ASGI application that exposes a REST HTTP API alongside its streaming WebSocket. - [Remote Access](https://useagentos.dev/docs/core/remote-access.md): The gateway controls chat, tools, sessions, channels, approvals and configuration, all with your provider credentials. - [Run the Gateway in a Container](https://useagentos.dev/docs/core/container-gateway.md): Run the AgentOS gateway from the published container image on a server, a VPS or a home box, then use it from the desktop app, the Web UI or the CLI on your… - [MCP Client Guide](https://useagentos.dev/docs/core/mcp.md): AgentOS connects to external Model Context Protocol servers and offers their tools to the agent. This page is about that client side. - [MCP Server Bridge](https://useagentos.dev/docs/core/mcp-server.md): AgentOS can run as a stdio MCP server bridge for MCP-capable clients. Use this when another local AI client should call into AgentOS session workflows through… - [Usage and Cost](https://useagentos.dev/docs/core/usage-and-cost.md): AgentOS records token usage and estimated cost from the running gateway. Use the cost view after routed, tool-heavy, channel, or long-context work to… - [Diagnostics and Replay](https://useagentos.dev/docs/core/diagnostics-and-replay.md): Diagnostics and replay help explain what happened during an AgentOS turn. Use them when a result was surprising, slow, expensive, interrupted, or hard to… - [Operations](https://useagentos.dev/docs/core/operations.md): This guide covers day-two commands: sessions, cron, cost, diagnostics, replay, migration, durable agents, MCP, and install inventory. - [Troubleshooting](https://useagentos.dev/docs/core/troubleshooting.md): The Web UI's Settings › Health at http://127.0.0.1:18791/control/settings/health also reports readiness and recovery steps when the gateway is running. ## AgentOS DEX: Reference - [DEX API](https://useagentos.dev/docs/dex/api.md): The AgentOS DEX API is a keyless HTTP API that lets an agent swap tokens. You ask for a price or a quote and get JSON back; a quote carries unsigned… - [DEX Contracts](https://useagentos.dev/docs/dex/contracts.md): The AgentOS DEX contracts are the on-chain layer behind the DEX API. A quote from the API is a transaction that calls the Router; the Router takes the AgentOS…