# 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:** * **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) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://pipeit.gitbook.io/plumbing-copilot-v1/readme.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.