Skip to content

Latest commit

Β 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Conductor Logo

⚑ Conductor

Universal Zero-Click Developer Workstation & Toolchain Orchestrator

License: MIT Node.js Python Platform CI Status PRs Welcome

Conductor is an autonomous, cross-platform developer environment tuner and toolchain orchestrator. It installs, optimizes, and configures 23+ premier developer tools, memory systems, API gateways, scrapers, and spec-driven frameworks β€” fully automatically, with zero clicks.

Quickstart β€’ Standalone EXE β€’ Toolchain Catalog β€’ Optimal Presets β€’ Web Dashboard β€’ Audits & Checklists β€’ CLI Manual


πŸš€ Quickstart (Zero-Click)

Set up your entire developer environment and synthesize optimal configurations with a single command:

⚑ Windows Native Executable (Zero Install)

Double-click conductor.exe in Windows Explorer or run from terminal:

.\conductor.exe

Automatically detects environment, launches the background service, and opens the Web Control Center in your browser.

πŸͺŸ Windows (PowerShell One-Liner)

irm https://raw.githubusercontent.com/AshrafMorningstar/conductor/main/scripts/install.ps1 | iex

🍎 macOS & 🐧 Linux (Bash One-Liner)

curl -fsSL https://raw.githubusercontent.com/AshrafMorningstar/conductor/main/scripts/install.sh | bash

πŸ“¦ Direct Clone & CLI

git clone https://github.com/AshrafMorningstar/conductor.git
cd conductor
node bin/conductor.js setup
node bin/conductor.js dashboard

πŸͺŸ Standalone Windows Executable (conductor.exe)

Conductor includes a pre-compiled native Windows PE 64-bit executable with embedded high-resolution application icons and metadata:

  • dist/conductor.exe and conductor.exe: Instant zero-click runner.
  • Auto-Browser Launch: Double-clicking opens the browser directly to http://127.0.0.1:4321.
  • CLI Mode: Run .\conductor.exe setup, .\conductor.exe test, .\conductor.exe doctor, or .\conductor.exe install <repo> from PowerShell / CMD.
  • Recompile with 1-Click:
    npm run build:exe
    # or execute scripts\build_exe.bat

πŸ—οΈ Architecture & Execution Pipeline

  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
  β”‚                   CONDUCTOR ORCHESTRATOR                    β”‚
  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                 β”‚
         β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
         β–Ό                       β–Ό                       β–Ό
 β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”       β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”       β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
 β”‚ System Doctor β”‚       β”‚ Toolchain Hub β”‚       β”‚ Settings Core β”‚
 β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€       β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€       β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
 β”‚ β€’ Node & Git  β”‚       β”‚ β€’ 23+ Repos   β”‚       β”‚ β€’ MCP Servers β”‚
 β”‚ β€’ Python/Pip  β”‚       β”‚ β€’ Auto-Clone  β”‚       β”‚ β€’ OmniRoute   β”‚
 β”‚ β€’ Fallback Gitβ”‚       β”‚ β€’ Depend. Res β”‚       β”‚ β€’ CursorRules β”‚
 β””β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”˜       β””β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”˜       β””β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”˜
         β”‚                       β”‚                       β”‚
         β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                 β”‚
                                 β–Ό
                 β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                 β”‚    Automated Verification     β”‚
                 β”‚   & Health Diagnostic Suite   β”‚
                 β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                 β”‚
                                 β–Ό
                 β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                 β”‚   Interactive Web Dashboard   β”‚
                 β”‚    http://127.0.0.1:4321      β”‚
                 β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

🧰 Curated Toolchain Catalog

Conductor automates the cloning, dependency resolution, and configuration for 23 modern developer repositories:

Repository Category Description Primary Runtime
spec-kit Frameworks GitHub's toolkit for Spec-Driven Development (SDD) Node.js
headroom Optimization Prompt context & token compression engine Python
headroom-desktop Optimization Desktop GUI monitor for token optimization Node.js
claude-mem Memory Persistent memory engine for Claude Code CLI Node.js
claude-memory-compiler Memory Compiles notes and code history into dense memory graphs Python
claude-code-setup Tooling Standardized plugin architecture and skills harness Node.js
one-skill-to-rule-them-all Skills Meta-skill orchestrator routing tasks to sub-skills Node.js
archify Visualization Architecture visualizer generating Mermaid diagrams Node.js
agentation Automation Visual canvas and browser automation workflow runner Node.js
ponytail Workflow Minimalist task runner and CLI daemon Python
agent-skills Skills Addy Osmani's curated developer skills library Node.js
graphify Memory Repository and AST knowledge graph compiler Python
omniroute Routing Multi-model intelligent API proxy with fallback Node.js
graft Tooling Git worktree and concurrent branch manager Node.js
agency-agents Agents Specialized autonomous agent roster (Architect, QA, UX) Node.js
codebase-memory-mcp MCP Long-term vector & graph memory MCP server Node.js
open-montage Visualization Open-source spatial visual workspace and asset board Node.js
strix Security Autonomous code vulnerability & penetration audit agent Python
agent-reach Scraping Deep research agent navigating modern SPAs Python
ashishpatel26-cheatsheets Reference Data science, ML & engineering cheat sheet library Docs
ecc-companion Tooling Engineers Code Companion snippet & workflow utilities Node.js
freellm-apis Routing Curated registry of verified free LLM proxy endpoints Docs
scrapling Scraping Undetectable, ultra-fast Python scraping engine Python

βš™οΈ Best Settings Synthesizer

When you run conductor setup (or click Synthesize Best Settings in the dashboard), Conductor automatically writes production-grade configurations into ./configs/ and syncs them with your system:

1. Model Context Protocol (MCP) Multi-Server Config

Auto-configures claude_desktop_config.json linking codebase-memory-mcp, graphify, omniroute, and scrapling:

{
  "mcpServers": {
    "codebase-memory": {
      "command": "node",
      "args": ["tools/codebase-memory-mcp/dist/index.js"],
      "env": { "MEMORY_STORAGE_PATH": ".conductor/memory" }
    },
    "graphify-code": {
      "command": "python",
      "args": ["-m", "graphify", "server"]
    },
    "omniroute-proxy": {
      "command": "node",
      "args": ["tools/omniroute/server.js"],
      "env": { "PORT": "8080", "ROUTER_MODE": "dynamic-fallback" }
    },
    "scrapling-stealth": {
      "command": "python",
      "args": ["-m", "scrapling.mcp"]
    }
  }
}

2. OmniRoute Universal Multi-Model Fallback Gateway

Pre-configures intelligent request routing with fallback chains, local model fallback (Ollama / LM Studio), and rate-limit circuit breakers in omniroute_config.json.

3. IDE Autonomous Rules (.cursorrules & .agentrules)

Sets strict architectural, security, and verification directives for coding assistants and agents, ensuring zero placeholders and full error boundaries.


πŸ–₯️ Web Control Center

Conductor includes an interactive local dashboard built with pure, modern Vanilla CSS and zero external frameworks.

node bin/conductor.js dashboard

Open http://127.0.0.1:4321 in any browser to:

  • Monitor system runtimes and host resource consumption.
  • Filter and install tools individually or in batches with one click.
  • Live-inspect synthesized configuration profiles.
  • Run automated verification suites with visual pass/fail badges.
  • Stream live execution logs in real time.

πŸ“‹ Production Audits & UX Matrix

Included in ./src/audits/ are complete production-readiness blueprints derived from senior principal engineering standards:

  • UX States Checklist: 18 mandatory UX states including Billing Lifecycle (Upgrade, Downgrade, Cancel, Payment Failure), Error Boundaries (400, 403, 404, 500), and Viewport States (Loading, Empty, Offline, Session Expired).
  • Production Readiness Audit: Circuit breakers, secret hygiene, structured telemetry, and zero-downtime release guidelines.

πŸ’» Command-Line Interface

Usage: conductor <command> [options]

Commands:
  doctor             Diagnose host runtimes, memory, and git availability
  list               List all 23 registered repositories and tools
  install [--all|id] Zero-click clone & dependency resolution for any or all tools
  setup              Synthesize best settings for MCP, Claude, Cursor, OmniRoute
  test               Execute automated verification and diagnostic suite
  dashboard          Launch the interactive web control center (default: 4321)
  help               Show this manual

πŸ§ͺ Automated Verification Suite

Conductor comes with a built-in diagnostic engine:

node bin/conductor.js test
  βœ… [PASS] Doctor System Inspection (682ms)
  βœ… [PASS] Repository Registry Integrity (0ms)
  βœ… [PASS] Optimal Settings Synthesis (2ms)
  βœ… [PASS] Workspace Storage Permissions (1ms)
  βœ… [PASS] MCP Multi-Server Configuration Schema (0ms)

  Summary: 5/5 Passed, 0 Failed.

🀝 Contributing

Contributions, additional tool adapters, and configuration presets are welcomed!

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/new-tool)
  3. Commit your changes (git commit -m 'Add awesome tool preset')
  4. Push to the branch (git push origin feature/new-tool)
  5. Open a Pull Request

πŸ“„ License

Distributed under the MIT License. See LICENSE for details.

Developed with ❀️ by Ashraf Morningstar.

About

Universal Zero-Click Developer Workstation & Toolchain Orchestrator. Autonomous environment setup, optimal settings synthesizer, and health verification.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages