conductor-kit 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Skyline-23
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ko.md

@@ -0,0 +1,144 @@
+# conductor-kit
+
+**Codex CLI**, **Claude Code**, **Gemini CLI**를 위한 글로벌 스킬팩과 통합 MCP 서버입니다.
+
+**언어**: [English](README.md) | 한국어
+
+## 이게 뭔가요?
+
+conductor-kit은 다음을 도와줍니다:
+- 일관된 오케스트레이션 워크플로우 사용 (검색 → 계획 → 실행 → 검증)
+- 여러 AI CLI 간의 작업 위임 (Codex, Claude, Gemini)
+- 원하는 CLI에 전문 스킬과 커맨드 로드
+
+## 빠른 시작
+
+### 설치 (macOS)
+```bash
+brew tap Skyline-23/conductor-kit
+brew install --cask conductor-kit
+conductor install
+```
+
+### 수동 설치
+```bash
+git clone https://github.com/Skyline-23/conductor-kit ~/.conductor-kit
+cd ~/.conductor-kit
+go build -o ~/.local/bin/conductor ./cmd/conductor
+conductor install
+```
+
+### 설치 확인
+```bash
+conductor status   # CLI 가용성 및 인증 상태 확인
+conductor doctor   # 전체 진단
+```
+
+## 사용법
+
+### 1. 스킬 사용
+Claude Code 또는 Codex CLI에서 다음으로 트리거:
+- `conductor` 또는 `symphony` 또는 `sym`
+
+### 2. 슬래시 커맨드
+| Claude Code | Codex CLI |
+|-------------|-----------|
+| `/conductor-plan` | `/prompts:conductor-plan` |
+| `/conductor-search` | `/prompts:conductor-search` |
+| `/conductor-implement` | `/prompts:conductor-implement` |
+| `/conductor-release` | `/prompts:conductor-release` |
+| `/conductor-symphony` | `/prompts:conductor-symphony` |
+
+### 3. MCP 도구 사용 (CLI 간 위임)
+
+통합 MCP 서버 등록:
+
+**Claude Code** (`~/.claude/mcp.json`):
+```json
+{
+  "mcpServers": {
+    "conductor": {
+      "command": "conductor",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+**Codex CLI**:
+```bash
+codex mcp add conductor -- conductor mcp
+```
+
+사용 가능한 MCP 도구:
+| 도구 | 설명 |
+|------|------|
+| `codex` | Codex CLI 세션 실행 |
+| `codex-reply` | Codex 세션 계속 |
+| `claude` | Claude Code 세션 실행 |
+| `claude-reply` | Claude 세션 계속 |
+| `gemini` | Gemini CLI 세션 실행 |
+| `gemini-reply` | Gemini 세션 계속 |
+| `conductor` | 역할 기반 라우팅 (config 사용) |
+| `conductor-reply` | conductor 세션 계속 |
+| `status` | CLI 가용성 및 인증 확인 |
+
+프롬프트에서 사용 예시:
+```
+gemini 도구를 사용해서 인증 로직을 코드베이스에서 검색해줘
+```
+
+## 설정
+
+설정 파일: `~/.conductor-kit/conductor.json`
+
+### 역할 기반 라우팅 (기본값)
+```json
+{
+  "roles": {
+    "sage": { "cli": "codex", "model": "gpt-5.2-codex", "reasoning": "medium", "description": "Deep reasoning for complex problems" },
+    "scout": { "cli": "gemini", "model": "gemini-3-flash", "description": "Web search and research" },
+    "pathfinder": { "cli": "gemini", "model": "gemini-3-flash", "description": "Codebase exploration and navigation" },
+    "pixelator": { "cli": "gemini", "model": "gemini-3-pro", "description": "Web UI/UX design and frontend" }
+  }
+}
+```
+
+### 설정 마법사
+```bash
+conductor settings              # 대화형 TUI 마법사
+conductor settings --list-models --cli codex  # 사용 가능한 모델 목록
+```
+
+자세한 설정 옵션은 [CONFIGURATION.md](docs/CONFIGURATION.md)를 참조하세요.
+
+## 요구 사항
+
+- **호스트 CLI**: Codex CLI, Claude Code, Gemini CLI 중 최소 하나
+- **Go 1.24+**: 소스에서 빌드할 때만 필요
+- **macOS**: Homebrew cask 설치용 (Linux: 수동 설치 사용)
+
+## 명령어 참조
+
+| 명령어 | 설명 |
+|--------|------|
+| `conductor install` | CLI에 스킬/커맨드 설치 |
+| `conductor uninstall` | 설치된 파일 제거 |
+| `conductor status` | CLI 인증 및 가용성 확인 |
+| `conductor doctor` | 전체 진단 |
+| `conductor settings` | 역할 및 모델 설정 |
+| `conductor mcp` | 통합 MCP 서버 시작 |
+
+## 제거
+
+```bash
+# Homebrew
+brew uninstall --cask conductor-kit
+
+# 수동
+conductor uninstall
+```
+
+## 라이선스
+
+MIT

package/README.md

@@ -0,0 +1,144 @@
+# conductor-kit
+
+A global skills pack for **Codex CLI**, **Claude Code**, and **Gemini CLI** with a unified MCP server for cross-CLI orchestration.
+
+**Language**: English | [한국어](README.ko.md)
+
+## What is this?
+
+conductor-kit helps you:
+- Use a consistent orchestration workflow (search → plan → execute → verify)
+- Delegate tasks between different AI CLIs (Codex, Claude, Gemini)
+- Load specialized skills and commands into your preferred CLI
+
+## Quick Start
+
+### Install (macOS)
+```bash
+brew tap Skyline-23/conductor-kit
+brew install --cask conductor-kit
+conductor install
+```
+
+### Install (Manual)
+```bash
+git clone https://github.com/Skyline-23/conductor-kit ~/.conductor-kit
+cd ~/.conductor-kit
+go build -o ~/.local/bin/conductor ./cmd/conductor
+conductor install
+```
+
+### Verify Installation
+```bash
+conductor status   # Check CLI availability and auth status
+conductor doctor   # Full diagnostics
+```
+
+## Usage
+
+### 1. Use the Skill
+In Claude Code or Codex CLI, trigger by saying:
+- `conductor` or `symphony` or `sym`
+
+### 2. Use Slash Commands
+| Claude Code | Codex CLI |
+|-------------|-----------|
+| `/conductor-plan` | `/prompts:conductor-plan` |
+| `/conductor-search` | `/prompts:conductor-search` |
+| `/conductor-implement` | `/prompts:conductor-implement` |
+| `/conductor-release` | `/prompts:conductor-release` |
+| `/conductor-symphony` | `/prompts:conductor-symphony` |
+
+### 3. Use MCP Tools (Cross-CLI Delegation)
+
+Register the unified MCP server:
+
+**Claude Code** (`~/.claude/mcp.json`):
+```json
+{
+  "mcpServers": {
+    "conductor": {
+      "command": "conductor",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+**Codex CLI**:
+```bash
+codex mcp add conductor -- conductor mcp
+```
+
+Available MCP tools:
+| Tool | Description |
+|------|-------------|
+| `codex` | Run Codex CLI session |
+| `codex-reply` | Continue Codex session |
+| `claude` | Run Claude Code session |
+| `claude-reply` | Continue Claude session |
+| `gemini` | Run Gemini CLI session |
+| `gemini-reply` | Continue Gemini session |
+| `conductor` | Role-based routing (uses config) |
+| `conductor-reply` | Continue conductor session |
+| `status` | Check CLI availability and auth |
+
+Example usage in your prompt:
+```
+Use the gemini tool to search the codebase for authentication logic
+```
+
+## Configuration
+
+Config file: `~/.conductor-kit/conductor.json`
+
+### Role-based Routing (Default)
+```json
+{
+  "roles": {
+    "sage": { "cli": "codex", "model": "gpt-5.2-codex", "reasoning": "medium", "description": "Deep reasoning for complex problems" },
+    "scout": { "cli": "gemini", "model": "gemini-3-flash", "description": "Web search and research" },
+    "pathfinder": { "cli": "gemini", "model": "gemini-3-flash", "description": "Codebase exploration and navigation" },
+    "pixelator": { "cli": "gemini", "model": "gemini-3-pro", "description": "Web UI/UX design and frontend" }
+  }
+}
+```
+
+### Setup Wizard
+```bash
+conductor settings              # Interactive TUI wizard
+conductor settings --list-models --cli codex  # List available models
+```
+
+For detailed configuration options, see [CONFIGURATION.md](docs/CONFIGURATION.md).
+
+## Requirements
+
+- **Host CLI**: At least one of Codex CLI, Claude Code, or Gemini CLI
+- **Go 1.24+**: Only if building from source
+- **macOS**: For Homebrew cask install (Linux: use manual install)
+
+## Commands Reference
+
+| Command | Description |
+|---------|-------------|
+| `conductor install` | Install skills/commands to CLIs |
+| `conductor uninstall` | Remove installed files |
+| `conductor status` | Check CLI auth and availability |
+| `conductor doctor` | Full diagnostics |
+| `conductor settings` | Configure roles and models |
+| `conductor mcp` | Start unified MCP server |
+
+## Uninstall
+
+```bash
+# Homebrew
+brew uninstall --cask conductor-kit
+
+# Manual
+conductor uninstall
+```
+
+## License
+
+MIT

package/bin/conductor

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+
+const BINARY_NAME = 'conductor';
+
+function getBinaryPath() {
+  // Check for binary in package directory first
+  const packageBinary = path.join(__dirname, '..', 'native', BINARY_NAME);
+  if (fs.existsSync(packageBinary)) {
+    return packageBinary;
+  }
+
+  // Check common global install locations
+  const homeDir = os.homedir();
+  const possiblePaths = [
+    path.join(homeDir, '.conductor-kit', 'bin', BINARY_NAME),
+    '/usr/local/bin/' + BINARY_NAME,
+    '/opt/homebrew/bin/' + BINARY_NAME,
+  ];
+
+  for (const p of possiblePaths) {
+    if (fs.existsSync(p)) {
+      return p;
+    }
+  }
+
+  return null;
+}
+
+function main() {
+  const binaryPath = getBinaryPath();
+
+  if (!binaryPath) {
+    console.error('Error: conductor binary not found.');
+    console.error('Run postinstall or install via Homebrew:');
+    console.error('  brew install Skyline-23/conductor-kit/conductor-kit');
+    process.exit(1);
+  }
+
+  const args = process.argv.slice(2);
+  const child = spawn(binaryPath, args, {
+    stdio: 'inherit',
+    env: {
+      ...process.env,
+      CONDUCTOR_NPX: '1',
+    },
+  });
+
+  child.on('error', (err) => {
+    console.error(`Failed to start conductor: ${err.message}`);
+    process.exit(1);
+  });
+
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+    } else {
+      process.exit(code ?? 1);
+    }
+  });
+}
+
+main();

package/commands/conductor-debug.md

@@ -0,0 +1,10 @@
+---
+description: "Debug mode: trace bugs and analyze errors."
+argument-hint: "error message or symptom"
+---
+
+Load conductor skill. Activate debug mode.
+
+Delegate to sage for root cause analysis. Trace execution paths, check logs.
+
+Refer to skills/conductor/SKILL.md for detailed instructions.

package/commands/conductor-docs.md

@@ -0,0 +1,10 @@
+---
+description: "Docs mode: write or update documentation."
+argument-hint: "what to document"
+---
+
+Load conductor skill. Activate docs mode.
+
+Delegate to author role via MCP. Keep docs concise and accurate.
+
+Refer to skills/conductor/SKILL.md for detailed instructions.

package/commands/conductor-explain.md

@@ -0,0 +1,10 @@
+---
+description: "Explain mode: understand and explain code or architecture."
+argument-hint: "what to explain"
+---
+
+Load conductor skill. Activate explain mode.
+
+Trace code flow, explain architecture decisions, document patterns.
+
+Refer to skills/conductor/SKILL.md for detailed instructions.

package/commands/conductor-implement.md

@@ -0,0 +1,10 @@
+---
+description: "Implement mode: make small, safe code changes."
+argument-hint: "what to implement"
+---
+
+Load conductor skill. Activate implement mode.
+
+Minimal surgical edits. Verify with tests. Rollback when stuck.
+
+Refer to skills/conductor/SKILL.md for detailed instructions.

package/commands/conductor-migrate.md

@@ -0,0 +1,10 @@
+---
+description: "Migrate mode: upgrade versions or migrate frameworks."
+argument-hint: "migration target"
+---
+
+Load conductor skill. Activate migrate mode.
+
+Plan migration steps, identify breaking changes, update dependencies safely.
+
+Refer to skills/conductor/SKILL.md for detailed instructions.

package/commands/conductor-plan.md

@@ -0,0 +1,10 @@
+---
+description: "Plan mode: read-only planning with no edits."
+argument-hint: "task to plan"
+---
+
+Load conductor skill. Activate plan mode.
+
+Read-only. No edits allowed. Output 3-6 steps with success criteria.
+
+Refer to skills/conductor/SKILL.md for detailed instructions.

package/commands/conductor-refactor.md

@@ -0,0 +1,10 @@
+---
+description: "Refactor mode: improve code structure without changing behavior."
+argument-hint: "what to refactor"
+---
+
+Load conductor skill. Activate refactor mode.
+
+Extract patterns, remove duplication, improve naming. Verify behavior unchanged.
+
+Refer to skills/conductor/SKILL.md for detailed instructions.

package/commands/conductor-release.md

@@ -0,0 +1,10 @@
+---
+description: "Release mode: release checklist and validation."
+argument-hint: "version or release scope"
+---
+
+Load conductor skill. Activate release mode.
+
+Checklist: version bump, changelog, validation, secret scan.
+
+Refer to skills/conductor/SKILL.md for detailed instructions.

package/commands/conductor-review.md

@@ -0,0 +1,10 @@
+---
+description: "Review mode: code review and quality inspection."
+argument-hint: "PR number, file, or scope"
+---
+
+Load conductor skill. Activate review mode.
+
+Delegate to sage for deep analysis. Check for bugs, security issues, style violations.
+
+Refer to skills/conductor/SKILL.md for detailed instructions.

package/commands/conductor-search.md

@@ -0,0 +1,10 @@
+---
+description: "Search mode: explore and analyze codebase."
+argument-hint: "what to search for"
+---
+
+Load conductor skill. Activate search mode.
+
+Delegate to pathfinder/scout roles via MCP. Evidence over opinions.
+
+Refer to skills/conductor/SKILL.md for detailed instructions.

package/commands/conductor-security.md

@@ -0,0 +1,10 @@
+---
+description: "Security mode: scan for vulnerabilities and security issues."
+argument-hint: "scope or specific concern"
+---
+
+Load conductor skill. Activate security mode.
+
+Delegate to sage for vulnerability analysis. Check dependencies, secrets, OWASP risks.
+
+Refer to skills/conductor/SKILL.md for detailed instructions.

package/commands/conductor-symphony.md

@@ -0,0 +1,10 @@
+---
+description: "Symphony mode: full orchestration loop (search -> plan -> execute -> verify -> cleanup)."
+argument-hint: "task or objective"
+---
+
+Load conductor skill. Activate symphony mode.
+
+Your first response must start with "SYMPHONY MODE ENABLED!".
+
+Refer to skills/conductor/SKILL.md for detailed instructions.

package/commands/conductor-test.md

@@ -0,0 +1,10 @@
+---
+description: "Test mode: write and run tests."
+argument-hint: "what to test"
+---
+
+Load conductor skill. Activate test mode.
+
+Write tests for specified code. Run tests and report coverage.
+
+Refer to skills/conductor/SKILL.md for detailed instructions.

package/config/conductor.json

@@ -0,0 +1,44 @@
+{
+  "defaults": {
+    "idle_timeout_ms": 120000,
+    "summary_only": true,
+    "max_parallel": 4,
+    "retry": 0,
+    "retry_backoff_ms": 500,
+    "log_prompt": false
+  },
+
+  "roles": {
+    "sage": {
+      "cli": "codex",
+      "model": "gpt-5.2-codex",
+      "reasoning": "medium",
+      "description": "Deep reasoning for complex problems"
+    },
+    "scout": {
+      "cli": "gemini",
+      "model": "gemini-3-flash",
+      "description": "Web search and research"
+    },
+    "pathfinder": {
+      "cli": "gemini",
+      "model": "gemini-3-flash",
+      "description": "Codebase exploration and navigation"
+    },
+    "pixelator": {
+      "cli": "gemini",
+      "model": "gemini-3-pro",
+      "description": "Web UI/UX design and frontend"
+    },
+    "author": {
+      "cli": "gemini",
+      "model": "gemini-3-flash",
+      "description": "Documentation and technical writing"
+    },
+    "vision": {
+      "cli": "gemini",
+      "model": "gemini-3-flash",
+      "description": "Image and screenshot analysis"
+    }
+  }
+}

package/config/conductor.schema.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Conductor Config",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "defaults": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "idle_timeout_ms": { "type": "integer", "minimum": 0 },
+        "max_parallel": { "type": "integer", "minimum": 0 },
+        "retry": { "type": "integer", "minimum": 0 },
+        "retry_backoff_ms": { "type": "integer", "minimum": 0 },
+        "log_prompt": { "type": "boolean" }
+      }
+    },
+    "roles": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "cli": { "type": "string" },
+          "args": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "model_flag": { "type": "string" },
+          "model": { "type": "string" },
+          "models": {
+            "type": "array",
+            "items": {
+              "anyOf": [
+                { "type": "string" },
+                {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "name": { "type": "string" },
+                    "reasoning_effort": { "type": "string" },
+                    "reasoning": { "type": "string" }
+                  }
+                }
+              ]
+            }
+          },
+          "reasoning_flag": { "type": "string" },
+          "reasoning_key": { "type": "string" },
+          "reasoning": { "type": "string" },
+          "ready_cmd": { "type": "string" },
+          "ready_args": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "ready_timeout_ms": { "type": "integer" },
+          "env": {
+            "type": "object",
+            "additionalProperties": { "type": "string" }
+          },
+          "cwd": { "type": "string" },
+          "idle_timeout_ms": { "type": "integer", "minimum": 0 },
+          "max_parallel": { "type": "integer", "minimum": 0 },
+          "retry": { "type": "integer", "minimum": 0 },
+          "retry_backoff_ms": { "type": "integer", "minimum": 0 }
+        },
+        "required": ["cli"]
+      }
+    }
+  },
+  "required": ["roles"]
+}

package/config/mcp-bundles.json

@@ -0,0 +1,40 @@
+{
+  "bundles": {
+    "extended": {
+      "servers": [
+        {
+          "name": "search",
+          "command": "",
+          "args": [],
+          "enabled": false,
+          "note": "Add a search MCP server command here."
+        },
+        {
+          "name": "lsp",
+          "command": "",
+          "args": [],
+          "enabled": false,
+          "note": "Add an LSP MCP server command here."
+        },
+        {
+          "name": "ast",
+          "command": "",
+          "args": [],
+          "enabled": false,
+          "note": "Add an AST MCP server command here."
+        }
+      ]
+    },
+
+    "conductor": {
+      "servers": [
+        {
+          "name": "conductor",
+          "command": "conductor",
+          "args": ["mcp"],
+          "note": "Unified MCP server with codex/claude/gemini + role-based conductor routing."
+        }
+      ]
+    }
+  }
+}