Introduction

Polymux is a platform for building, running, and sharing AI agents that work the web on your behalf. Agents drive real browser sessions, hand off to one another, store secrets in a vault, and replay their runs — all from a workspace your team controls.

This documentation is split into two parts. The User guide walks through installing Polymux, getting set up, and using the product day-to-day. The Developer guide explains how to build and publish packaged workflows and connections so other people can install them in one click.

If you have not used Polymux before, start with Quickstart. If you arrived here looking for an API reference, jump straight to the API overview.

What Polymux gives you

Polymux is built around three primitives:

  • Sessions — a single conversation with one agent, backed by a live browser. Sessions stream every click, scroll, and form fill to your dashboard.
  • Workflows — a directed graph of agents, viewports, and tools. Workflows are versioned, can be scheduled, and can be packaged for the marketplace.
  • Workspaces — the shared container for your team's workflows, vault entries, files, and billing. Members are added by invitation and assigned roles.

These three concepts come up everywhere in the rest of the docs. If a section uses one without explaining it, this is the page to come back to.

What's new

This documentation site is itself live work-in-progress. Pages marked Draft in the sidebar are stubs. If a topic is missing entirely, the forum is the fastest way to ask.

How to read these docs

The left sidebar groups pages into sections. The right rail tracks where you are on the current page and lets you jump between headings. Every page ends with links to the previous and next page in reading order, so you can step through the whole guide from start to finish without going back to the sidebar.

Polymux is in active development. We bump these pages whenever the product changes, so it is worth checking back if you are following an older guide.