# agentlane

> agentlane gives each AI coding agent its own lane, a running copy of your app with its own ports, dev servers, database, and browser, iOS simulator or Android emulator.

Each link below is the Markdown copy of one page of the docs, in the order the site reads. llms-full.txt holds every page in one file.

## Start

- [Getting started](docs/getting-started.md): One command in your project, then one sentence to your agent.
- [Install for your agent](docs/install.md): What init detects, installs and writes for each agent, and the Claude Code plugin.
- [Where it runs](docs/requirements.md): Hosts, platforms and the tools each platform needs.

## How it works

- [What a lane holds](docs/lanes.md): Ports, a device or browser, data and processes, claimed per session and folder.
- [How setup decides](docs/setup.md): What the setup skill reads, asks and writes.
- [The CLI, the MCP server and the plugins](docs/parts.md): Which part an agent uses for what.
- [The skills](docs/skills.md): setup, dev-loop, drive and the verification skills: how an agent learns the project.
- [What makes it fast](docs/speed.md): A warm driver, a patched Maestro, a shared build cache and a reused device pool.

## Features

- [Bring a worktree up](docs/up.md): agentlane up, from a bare worktree to the running app.
- [Ports and dev servers](docs/services.md): Each service gets a free port and a ready check.
- [Simulators and emulators](docs/devices.md): A pool of simulators and emulators, one per lane.
- [Browsers for web apps](docs/browsers.md): Each web lane gets its own browser profile and driver session.
- [A database per lane](docs/resources.md): Give each lane its own copy of the data, created by up and dropped at release.
- [See and drive the app](docs/drive.md): look, run, screenshot and record, on a device or in a browser.
- [Evidence](docs/evidence.md): Screenshots, video, traces and logs that outlive the lane.
- [Doctor](docs/doctor.md): Is this instance worth driving? Read-only checks, each with its fix.
- [The build cache](docs/build-cache.md): One build per set of inputs, shared by every worktree.
- [The device guard and session hooks](docs/guard.md): Hooks that keep agents off each other's devices and browsers.

## Reference

- [CLI](docs/cli.md): Every command and flag.
- [MCP server](docs/mcp.md): The look, run and screenshot tools over MCP.
- [agentlane.json](docs/config.md): The config file, field by field.
- [Environment variables](docs/environment.md): What a lane exports, and the settings you can set.
- [Troubleshooting](docs/troubleshooting.md): Common failures and their fixes.
- [Questions](docs/faq.md): Physical devices, what leaves your machine, Linux, monorepos, CI and cost.
- [Honorable mentions](docs/acknowledgements.md): The projects agentlane builds on, and the ones it works beside.

## Optional

- [Changelog](changelog.md): What changed in each release, newest first.