> For the complete documentation index, see [llms.txt](https://pipeit.gitbook.io/plumbing-copilot-v1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pipeit.gitbook.io/plumbing-copilot-v1/readme.md).

# Welcome

Plumbing Copilot is a Revit plugin that generates plumbing pipe routes for you. You define the rules — slope, clearance, pipe type, fittings — pick a start and an end in your Revit model, and Plumbing Copilot returns clash-free pipe routes you can place as native Revit elements.

This documentation covers installation, the user interface, the routing workflow, and every setting along the way.

> **These docs cover Plumbing Copilot 1.5.** The headline addition in this release is **Auto Routing Elements**, which discovers routing volumes from your model automatically — see [Pathfinding Options → Auto Routing Elements](/plumbing-copilot-v1/control-panel/pathfinding-options.md#auto-routing-elements).

***

## How It Works

You work entirely inside Revit. Open the **Control Panel** from the **PipeIt** ribbon tab, set up a routing preference with your rules, and click **Route**. Pick a start and an end element; Plumbing Copilot finds a corridor through your model and proposes one or more pipe routes. Confirm a route and it's placed as standard Revit pipes, fittings, and connections.

Everything uses families, system types, and project standards already loaded in your project — no external software, no file exports, no proprietary content.

***

## Key Capabilities

* **Automated routing.** Pick two elements; get pipe routes back in seconds.
* **Multiple route options per run.** Several routes are returned so you can compare and pick — sortable by shortest length or fewest fittings, with clash counts on each.
* **Rule-based pathfinding.** Slope, minimum pipe length, clearance, and elbow style are honored exactly.
* **Auto Routing Elements.** Plumbing Copilot scans the area between your picks and uses the walls, floors, ceiling voids, and chases it finds as the routing corridor — no manual placement needed for most projects.
* **Manual routing elements.** When you want full control, place 3D volumes (Wall, Floor, Ceiling Void, Plumbing Chase, Wall/Column Side, Bridge Box, General Box) yourself to define exactly where pipes can travel.
* **Obstacle avoidance.** Choose which Revit element categories (structural framing, ductwork, cable trays, equipment, and more) the algorithm must route around.
* **Path boundaries.** Block specific zones (electrical rooms, floor openings, the exterior of the building) from any pipe routes.
* **Native Revit elements.** Generated routes are standard pipes, fittings, Wyes, Tees, and P-Traps from your loaded families. Edit, extend, or replace them with any Revit tool after placement.
* **Reusable routing preferences.** Save your rules as named routing preferences. Use them in **Manual** mode (you pick which one applies) or **Automatic** mode (Plumbing Copilot picks one whose launch conditions match the elements you selected).

***

## Supported Revit Versions

Plumbing Copilot supports **Autodesk Revit 2022 through 2026**.

***

## What You'll Learn

This documentation covers everything you need to get productive with Plumbing Copilot:

| Section                                                                                      | What It Covers                                                                                                                              |
| -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| [Getting Started](/plumbing-copilot-v1/getting-started/installation.md)                      | Installation, account and license setup, and your first automated route                                                                     |
| [Routing Workflow](/plumbing-copilot-v1/routing-workflow/place-routing-elements.md)          | The end-to-end routing process, from setting up the corridor to placing the route                                                           |
| [PipeIt Ribbon](/plumbing-copilot-v1/pipeit-ribbon/ribbon-tab.md)                            | The PipeIt ribbon tab and its three buttons (Control Panel, Route, Report Issue)                                                            |
| [Control Panel](/plumbing-copilot-v1/control-panel/control-panel.md)                         | The dockable Control Panel and its tabs (Routing Preferences, Obstacle Avoidance, Path Boundaries, Pathfinding Options, Settings & Account) |
| [Routing Preferences](/plumbing-copilot-v1/routing-preferences/routing-preferences-panel.md) | The Routing Preferences panel, launch conditions, and every setting on a routing preference                                                 |
| [Routing Elements](/plumbing-copilot-v1/routing-elements/overview.md)                        | The 3D volumes that define where pipes can travel — auto-discovered or placed manually                                                      |
| [Troubleshooting](/plumbing-copilot-v1/troubleshooting/common-issues.md)                     | Common issues, error reporting, and how to get support                                                                                      |

***

## Quick Links

* **New here?** Start with the [Quick Start Guide](/plumbing-copilot-v1/getting-started/quick-start.md).
* **Looking for a specific setting?** Use the [Control Panel](/plumbing-copilot-v1/control-panel/control-panel.md) overview as your starting point.
* **Hit a problem?** Check [Common Issues](/plumbing-copilot-v1/troubleshooting/common-issues.md) or [Contact Support](/plumbing-copilot-v1/troubleshooting/contact-support.md).

***

## Get in Touch

* **Support:** <support@pipeit.co>
* **Website:** [pipeit.co](https://pipeit.co)
* **Free Trial:** [Request a 30-day free trial](https://pipeit.co/contact?subject=trial) — granted on request
* **Enterprise:** [Request a demo](https://pipeit.co/contact?subject=demo)
