Back to Home
t3ta icon

coduck

Verified Safe

by t3ta

Overview

Orchestrates Codex jobs in isolated Git worktrees, integrated with Claude Code via the Model Context Protocol (MCP) server for automated code generation, review, and deployment.

Installation

Run Command
npm run mcp

Environment Variables

  • ORCHESTRATOR_PORT
  • ORCHESTRATOR_URL
  • WORKER_POLL_INTERVAL_MS
  • WORKTREE_BASE_DIR
  • CODEX_CLI_PATH
  • GIT_PATH
  • WORKER_CONCURRENCY
  • CODEX_MCP_TIMEOUT_MS
  • CODEX_REASONING_SUMMARY
  • CODEX_REASONING_FORMAT
  • ALLOWED_GIT_HOSTS
  • ORCHESTRATOR_DB_PATH
  • REPO_URL

Security Notes

The system uses `execFile`/`spawn` for Git and Codex CLI commands, which is inherently safer against shell injection than `exec`. A critical security measure, `validateRepoUrl`, mitigates SSRF by restricting external Git repository URLs to a configurable whitelist (GitHub and GitLab by default) and enforcing absolute local paths for 'no-worktree' mode. This protects the worker from fetching from malicious external URLs or making unintended requests to internal network services. No obvious hardcoded secrets, 'eval' calls, or code obfuscation were found. The 'no-worktree' mode, while intentional, allows the worker to operate directly on a specified absolute path (often `process.cwd()`), meaning a compromised orchestrator or an untrusted job creator could potentially cause unintended file system modifications outside of isolated worktrees. However, this is mitigated by validation on the `repo_url` for 'no-worktree' jobs (must be absolute path) and the design choice to not automatically clean up these directories.

Similar Servers

Stats

Interest Score0
Security Score8
Cost ClassMedium
Avg Tokens3000
Stars0
Forks0
Last Update2025-12-12

Tags

CodexOrchestratorGit WorktreeMCPClaude CodeJob Management