director
starsforks
How to install director?
fdmtl/director
$git clone https://github.com/fdmtl/director---
README.md
| 1 | <h1 align="center">Director</h1> |
| 2 | <p align="center">MCP Playbooks for AI agents</p> |
| 3 | |
| 4 | <p align="center"><code>curl -LsSf https://director.run/install.sh | sh</code></p> |
| 5 | |
| 6 | --- |
| 7 | |
| 8 | <div align="center"> |
| 9 | |
| 10 | [](https://www.gnu.org/licenses/agpl-3.0) |
| 11 | [](https://github.com/director-run/director/actions/workflows/ci.yml) |
| 12 | [](https://github.com/director-run/director/actions/workflows/release.yml) |
| 13 | [](https://www.npmjs.com/package/@director.run/cli) |
| 14 | |
| 15 | </div> |
| 16 | |
| 17 | # Overview |
| 18 | |
| 19 | Director allows you to provide <ins>**playbooks**</ins> to AI Agents. A playbook is a set of <ins>**MCP tools**</ins>, <ins>**prompts**</ins> and <ins>**configuration**</ins>, that give agents new <ins>**skills**</ins>. You can connect Claude, Cursor and VSCode in 1-click, or integrate manually through a single MCP endpoint. |
| 20 | |
| 21 | Playbooks are portable and can easily be switched in and out of context. Director is local-first - setup and client integration takes 30 seconds. In addition, Director provides all of the MCP management functionality that you'd expect: tool filtering, logging, strong isolation, and unified OAuth. |
| 22 | |
| 23 | <br /><br /> |
| 24 | |
| 25 | https://github.com/user-attachments/assets/cafc0902-a854-4ee8-ac89-b7535f10c93d |
| 26 | |
| 27 | |
| 28 | ## Key Features |
| 29 | |
| 30 | - 📚 **Playbooks** - Maintain sets of tools, prompts and config for different tasks or environments. |
| 31 | - 🚀 **1-Click Integration** - Switch playbooks with a single click. Currently supports Claude Code, Claude Desktop, Cursor, VSCode |
| 32 | - 🔗 **Shareable** - Playbooks are accessible through a single MCP endpoint, making them easy to share across agents. |
| 33 | - 🏠 **Local-First** - Director is local-first, designed to easily run on your own machine or infrastructure. |
| 34 | - 🔑 **Unified OAuth** - Connect to OAuth MCPs centrally, and use them across all of your agents. |
| 35 | - 🎯 **Tool Filtering** - Select only the MCP tools that are required for the specific task, preserving context. |
| 36 | - 📊 **Observability** - Centralized JSON logging, that allows you to understand exactly what your agent is doing. |
| 37 | - 🔌 **MCP Compliant** - Just works with any MCP server or client. Up to date with the latest MCP spec. |
| 38 | |
| 39 | # Quickstart |
| 40 | |
| 41 | ```bash |
| 42 | # Install Director |
| 43 | $ curl -LsSf https://director.run/install.sh | sh |
| 44 | |
| 45 | # Start the onboarding flow |
| 46 | $ director quickstart |
| 47 | ``` |
| 48 | |
| 49 | # Core Concepts |
| 50 | |
| 51 | ## Playbooks |
| 52 | |
| 53 | A playbook is a set of tools, prompts and configuration, used to provide specific capabilities to your agent. Under the hood, playbooks are built on top of the MCP tools & prompts primitives. |
| 54 | |
| 55 | The easiest way to author a playbook is via the UI (`director studio`). But you can also use the CLI. You can have many playbooks, typically one per task or per environment. You can connect to them via a single CLI command or directly over a URL. |
| 56 | |
| 57 | ## Architecture |
| 58 | |
| 59 | At a high level, Director is a service that sits between your agents and MCP servers. It's transparent to clients, requiring no additional tokens. It models playbooks, which can be thought of as standalone, portable skills that enhance your AI agent with new capabilities. |
| 60 | |
| 61 | <img src="https://github.com/director-run/director/blob/main/apps/docs/images/director-highlevel-overview.png" width="100%" alt="director demo"> |
| 62 | |
| 63 | # Usage |
| 64 | |
| 65 | ## Installation |
| 66 | ```bash |
| 67 | # Install the director CLI + dependencies (node, npm & uvx) via the 1-liner: |
| 68 | $ curl -LsSf https://director.run/install.sh | sh |
| 69 | |
| 70 | # Alternatively, install through npm: |
| 71 | $ npm install -g @director.run/cli |
| 72 | |
| 73 | # Start director & open the UI |
| 74 | $ director quickstart |
| 75 | ``` |
| 76 | |
| 77 | ## The Studio (Web UI) |
| 78 | |
| 79 | The simplest way to interact with director is via the admin interface: |
| 80 | |
| 81 | ```bash |
| 82 | # Open studio in your browser |
| 83 | $ director studio |
| 84 | ``` |
| 85 | |
| 86 | ## CLI Reference |
| 87 | |
| 88 | ```bash |
| 89 | Playbooks for your AI agent |
| 90 | |
| 91 | USAGE |
| 92 | director <command> [subcommand] [flags] |
| 93 | |
| 94 | CORE COMMANDS |
People who liked this also viewed
6 picksType
- fastmcp🚀 The fast, Pythonic way to build MCP servers and clients.MCP ServersJul 2026
- playwright-mcpPlaywright MCP serverMCP ServersJul 2026
- ext-appsOfficial repo for spec & SDK of MCP Apps protocol - standard for UIs embedded AI chatbots, served by MCP serversMCP ServersJul 2026
- langchain-mcp-adaptersLangChain 🔌 MCPMCP ServersJul 2026
- mcporterCall MCPs via TypeScript, masquerading as simple TypeScript API. Or package them as cli.MCP ServersJul 2026
- mcp-proxyA bridge between Streamable HTTP and stdio MCP transportsMCP ServersJul 2026
