---
name: agora-by-olimpia
description: "Read the Agora by Olimpia docs instead of answering from memory. Agora is an agent-native desktop runtime: one Linux desktop and one Chromium per workspace, shared by many AI agents with their own cursors, input seats and tabs. Open source, by Olimpia. Use when a task involves Agora by Olimpia: how it works, how to set it up or configure it, or its API."
---

# Agora by Olimpia

Agora is an agent-native desktop runtime: one Linux desktop and one Chromium per workspace, shared by many AI agents with their own cursors, input seats and tabs. Open source, by Olimpia.

This skill points you at the Agora by Olimpia docs, at https://agora.olimpia.dev/. When a task involves Agora by Olimpia, read the relevant page before relying on what you remember: the docs are the source of truth, and they change.

## Reading the docs

- Any page as Markdown: add `.md` to its URL (the home page is https://agora.olimpia.dev/index.md). Every page link below already points at the Markdown.
- [llms.txt](https://agora.olimpia.dev/llms.txt): every page with a one-line summary.
- [llms-full.txt](https://agora.olimpia.dev/llms-full.txt): every page in one file, for when you need all of it.
- [JSON API](https://agora.olimpia.dev/api/docs/pages.json): the page index, with each page as JSON and Markdown.

## Pages

### Get started

- [Introduction](https://agora.olimpia.dev/introduction.md): Agora gives AI agents a real Linux computer they can share. One desktop and one Chromium per workspace, many agents on it at once, each with its own cursor, keyboard and tabs.
- [Install](https://agora.olimpia.dev/install.md): Install Agora on Ubuntu or Debian with one command, or build it from source.
- [Quickstart](https://agora.olimpia.dev/quickstart.md): Create a workspace, open a tab, read it the way an agent does, watch it live and launch a subagent.
- [Uninstall](https://agora.olimpia.dev/uninstall.md): Remove Agora and, optionally, every workspace, browser profile and token it stored.

### Guides

- [Concepts](https://agora.olimpia.dev/concepts.md): Workspaces and their lifecycle, cursors and subagents, input seats and arbitration, human takeover, streaming modes and persistence.
- [Paseo plugin](https://agora.olimpia.dev/paseo.md): Watch and steer Agora desktops from Paseo, on desktop or mobile, and give every Paseo agent its own Agora cursor.
- [Security model](https://agora.olimpia.dev/security.md): How Agora authenticates callers, isolates browsers and apps, and what it does not protect against.

### Reference

- [CLI](https://agora.olimpia.dev/cli.md): Every agora subcommand and environment variable.
- [HTTP API](https://agora.olimpia.dev/http-api.md): Every endpoint of the Agora daemon, with authentication, request bodies and errors.
- [MCP tools](https://agora.olimpia.dev/mcp-tools.md): The 52 tools of the agora mcp server, grouped by what they control.
- [Benchmarks](https://agora.olimpia.dev/benchmarks.md): Agora against an Xvfb + x11vnc + noVNC + Chrome stack, and the token cost of Agora subagents before and after the lean launcher.

### Project

- [FAQ](https://agora.olimpia.dev/faq.md): Common questions about Agora.
- [Changelog](https://agora.olimpia.dev/changelog.md): Release notes for Agora.

### For agents

- [Agora for agents](https://agora.olimpia.dev/agents.md): How an AI agent connects to Agora and uses its MCP tools to browse, drive desktop apps, run subagents and hand off to a human.
- [Connect your agent](https://agora.olimpia.dev/agents/connect.md): Add the Agora MCP server to Claude Code, Codex or any MCP client, install the Agora skill and read these docs as Markdown.
- [Tools](https://agora.olimpia.dev/agents/tools.md): How an agent should use each family of Agora MCP tools (browser, desktop, cursors, board, workspaces, human handoff) and keep token usage low.
- [Workflows](https://agora.olimpia.dev/agents/workflows.md): End-to-end tool sequences for common agent tasks in Agora, from testing a web app to running parallel subagents and passing a CAPTCHA.
- [Prompts](https://agora.olimpia.dev/agents/prompts.md): Prompts to copy and give your agent once Agora is connected, from testing a site to running parallel subagents.
- [Security](https://agora.olimpia.dev/agents/security.md): What an agent connected to Agora can and cannot reach, how token scopes and permissions work, how human handoff works and when to use sandboxed workspaces.