$git clone https://github.com/SixHq/Overture<br>
| 1 | <p align="center"> |
| 2 | <picture> |
| 3 | <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/SixHq/Overture/main/assets/overture-logo-dark.png"> |
| 4 | <img src="https://raw.githubusercontent.com/SixHq/Overture/main/assets/overture-logo-light.png" alt="Overture" width="400"> |
| 5 | </picture> |
| 6 | </p> |
| 7 | |
| 8 | <p align="center"> |
| 9 | <strong>See the plan before the code. Approve it. Then watch it execute.</strong> |
| 10 | </p> |
| 11 | |
| 12 | <p align="center"> |
| 13 | <a href="https://www.npmjs.com/package/overture-mcp"><img src="https://img.shields.io/npm/v/overture-mcp?style=for-the-badge&color=blue" alt="npm version"></a> |
| 14 | <a href="https://github.com/SixHq/Overture/actions"><img src="https://img.shields.io/github/actions/workflow/status/SixHq/Overture/ci.yml?branch=main&style=for-the-badge" alt="CI status"></a> |
| 15 | <a href="https://www.npmjs.com/package/overture-mcp"><img src="https://img.shields.io/npm/dm/overture-mcp?style=for-the-badge&color=orange" alt="npm downloads"></a> |
| 16 | <a href="https://github.com/SixHq/Overture/discussions"><img src="https://img.shields.io/github/discussions/SixHq/Overture?style=for-the-badge&color=purple" alt="Discussions"></a> |
| 17 | <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge" alt="MIT License"></a> |
| 18 | </p> |
| 19 | |
| 20 | <p align="center"> |
| 21 | <a href="#-the-problem">Problem</a> • |
| 22 | <a href="#-the-solution">Solution</a> • |
| 23 | <a href="#-installation">Install</a> • |
| 24 | <a href="#-features">Features</a> • |
| 25 | <a href="#-mcp-marketplace">Marketplace</a> • |
| 26 | <a href="#-configuration">Config</a> • |
| 27 | <a href="https://github.com/SixHq/Overture/discussions">Discussions</a> |
| 28 | </p> |
| 29 | |
| 30 | <br> |
| 31 | |
| 32 | <p align="center"> |
| 33 | |
| 34 | https://github.com/user-attachments/assets/eeb9c4cb-c80d-42da-bf63-c0c4ecb1e5d6 |
| 35 | |
| 36 | </p> |
| 37 | |
| 38 | --- |
| 39 | |
| 40 | ## 🔥 The Problem |
| 41 | |
| 42 | Every AI coding agent today — **Cursor**, **Claude Code**, **Cline**, **Copilot** — works the same way: |
| 43 | |
| 44 | <table> |
| 45 | <tr> |
| 46 | <td width="50%"> |
| 47 | |
| 48 | ### What Happens Now |
| 49 | |
| 50 | 1. You type a prompt |
| 51 | 2. Agent **immediately starts writing code** |
| 52 | 3. You have **zero visibility** into what it's doing |
| 53 | 4. You realize it misunderstood your request |
| 54 | 5. **Hundreds of lines of code** need to be discarded |
| 55 | 6. You've wasted tokens, time, and patience |
| 56 | |
| 57 | </td> |
| 58 | <td width="50%"> |
| 59 | |
| 60 | ### Text Plans Don't Help |
| 61 | |
| 62 | Some agents show plans as text in chat. But text fails to show: |
| 63 | |
| 64 | - **Dependencies** — which tasks depend on what? |
| 65 | - **Branch points** — what alternative approaches exist? |
| 66 | - **Context requirements** — which files, APIs, or secrets are needed? |
| 67 | - **Complexity** — which steps are risky? |
| 68 | - **Progress** — what's done, what's next? |
| 69 | |
| 70 | </td> |
| 71 | </tr> |
| 72 | </table> |
| 73 | |
| 74 | <p align="center"> |
| 75 | <img src="https://raw.githubusercontent.com/SixHq/Overture/main/assets/problem-illustration.png" alt="The Problem" width="700"> |
| 76 | </p> |
| 77 | |
| 78 | --- |
| 79 | |
| 80 | ## ✨ The Solution |
| 81 | |
| 82 | **Overture** intercepts your AI agent's planning phase and renders it as an **interactive visual flowchart** — before any code is written. |
| 83 | |
| 84 | <p align="center"> |
| 85 | <img src="https://raw.githubusercontent.com/SixHq/Overture/main/assets/solution-screenshot.png" alt="Overture Solution" width="900"> |
| 86 | </p> |
| 87 | |
| 88 | ### The agent doesn't write a single line of code until you approve the plan. |
| 89 | |
| 90 | <br> |
| 91 | |
| 92 | <table> |
| 93 | <tr> |
| 94 | <td align="center" width="20%"> |
| 95 | <img src="https://img.icons8.com/color/96/flow-chart.png" width="64"><br> |
| 96 | <strong>Visual Plans</strong><br> |
| 97 | <sub>Interactive flowchart with pan, zoom, and click-through navigation</sub> |
| 98 | </td> |
| 99 | <td align="center" width="20%"> |
| 100 | <img src="https://img.icons8.com/color/96/attach.png" width="64"><br> |
| 101 | <strong>Attach Context</strong><br> |
| 102 | <sub>Files, API keys, instructions per step</sub> |
| 103 | </td> |
| 104 | <td align="center" width="20%"> |
| 105 | <img src="https://img.icons8.com/color/96/split.png" width="64"><br> |
| 106 | <strong>Choose Approaches</strong><br> |
| 107 | <sub>Compare pros/cons of different paths</sub> |
| 108 | </td> |
| 109 | <td align="center" width="20%"> |
| 110 | <img src="https://img.icons8.com/color/96/lightning-bolt.png" width="64"><br> |
| 111 | <strong>Real-time Execution</strong><br> |
| 112 | <sub>Watch nodes light up with progress</sub> |
| 113 | </td> |
| 114 | <td align="cen |