Ordewell 다중 에이전트 작업 조율 도구 – 개요 및 주요 기능

Ordewell이 하는 일 — 하나의 목표를 편집 가능한 다중 에이전트 계획으로 전환

Ordewell은 일반 언어로 작성된 목표를 각 작업이 실행자, 모델, 사고 노력, 모드를 명시하는 타입화된 계획으로 변환합니다. 계획은 어떤 토큰도 소비되기 전에 편집할 수 있으므로 개발자는 각 작업에 적합한 모델을 선택하고 의존성을 재구성하며, 완료된 작업을 잃지 않고 단계를 추가하거나 제거할 수 있습니다.

  • 계획기는 읽기 전용 탐색 환경에서 작동합니다: 저장소를 쿼리하고, 명확화 질문을 하며, 마지막 메시지로 최종 계획을 생성합니다.
  • 실행은 각 AI 작업에 대해 별도의 코딩 에이전트 세션을 생성하며, 의존성 그래프를 존중하고 실행자 출력에 고유한 마커를 통해 완료 여부를 검증합니다.
  • 수동 작업은 사용자가 완료를 표시할 수 있는 체크리스트 항목으로 나타납니다.
  • 계획기에는 추가 API 키가 필요하지 않습니다. Claude Code, Codex, 또는 OpenCode에 이미 보유한 구독을 재사용할 수 있습니다.
  • 기본적으로 여러 실행자가 지원되며, 플러그인 매니페스트를 통해 추가 실행자를 추가할 수 있습니다.

빠른 시작 – 터미널 UI 설치 및 실행

npm install -g ordewell
ordewell               # 전체 화면 TUI를 시작합니다
  • 첫 번째 실행 시 계획기와 하나 이상의 실행자(예: Claude Code, Codex, OpenCode)를 선택하도록 요청합니다. 초기에는 API 키가 필요하지 않습니다.
  • 동일한 워크플로우는 npx ordewell (전역 설치 없이) 또는 VS Code 확장(code --install-extension ordewell.ordewell)에서도 작동합니다.
  • 헤드리스 자동화를 위해 모든 슬래시 명령어는 하위 명령어로도 사용 가능합니다. AI_PROVIDER 또는 적절한 *_API_KEY 환경 변수를 설정하여 UI 없이 ordewell plan … && ordewell run을 실행할 수 있습니다.

핵심 개념 및 워크플로우

  1. 목표 정의 – 자연어 설명을 제공합니다. 예: "공개 API에 요청 제한 기능 추가"
  2. 계획기 조사 – 계획기는 저장소를 읽기 전용으로 읽고, 명확화 질문을 하며, 증거를 수집합니다.
  3. 계획 생성 – 실행자, 모델, 노력, 모드가 주석 처리된 작업 목록이 순서대로 생성됩니다. 계획은 편집 가능한 타입화된 자산입니다.
  4. 실행 – 독립적인 작업은 병렬로 실행됩니다(기본 최대 3개 동시 세션). 각 AI 작업은 별도의 세션에서 실행되며, 수동 작업은 체크리스트로 변환됩니다.
  5. 판결 엔진 – 실행자 출력에 고유한 완료 마커가 나타날 때만 작업이 성공으로 표시됩니다. 종료 코드는 진단 증거로 유지되며, 작업은 수동으로 완료 또는 미완료로 표시할 수 있습니다.

세 가지 사용자 인터페이스, 하나의 핵심 엔진

인터페이스 주요 사용 사례
VS Code 확장 통합 스트리밍 타임라인, 실시간 조사 단계, 확장 가능한 작업 카드. 즉시 실행자 및 모델 재지정이 가능합니다.
터미널 UI (TUI) 전체 화면, 키보드 중심 워크플로우, SSH를 통한 사용; tab 키로 채팅 및 계획 패널 전환, 단일 키 단축키로 계획 제어(예: f 시작, E 전체 실행).
CLI 스크립트 가능, 헤드리스 자동화; 모든 UI 작업은 하위 명령어로도 사용 가능(ordewell plan, ordewell run, ordewell task-runner).

모든 인터페이스는 동일한 핵심 패키지(core/, cli/, vscode/, web/)를 공유하며, 로컬 데몬(ordewell web --daemon)을 통해 JSON-WebSocket API를 노출하여 통신합니다.

구성 필수 사항

설정 기본값 효과
제공자 키(OPENROUTER_API_KEY, ANTHROPIC_API_KEY, …) — 선택된 AI 제공자에 필요; Ordewell은 설정된 키에서 제공자를 자동 감지합니다.
ORCHESTRATOR_MODEL deepseek/deepseek-v4-flash 조사 및 계획 생성에 사용되는 계획기 모델
ORDEWELL_PLANNER_EFFORT — 코딩 에이전트 계획기의 노력 수준(예: high, low)
ORDEWELL_MAX_PARALLEL 3 최대 동시 AI 작업 세션 수(1–5)

환경 변수는 ordewell key set …, ordewell model set …, 또는 VS Code 설정 패널을 통해 설정할 수 있습니다. 변경 사항은 데몬 재시작 없이 즉시 적용됩니다.

확장성 – 사용자 정의 실행자 및 플러그인

  • 내장 실행자로는 Claude Code, Codex, OpenCode가 포함됩니다.
  • 추가 실행자는 플러그인 매니페스트(ordewell plugins create my-runner)를 생성하고 Git URL에서 설치(ordewell plugins install github:user/repo)하여 추가할 수 있습니다.
  • 플러그인은 GitHub, GitLab, Bitbucket, Codeberg에 호스팅할 수 있으며, 기타 소스는 로컬 복제가 필요합니다.

커뮤니티 피드백 – 허커 뉴스에서

@ramon156: “저는 DeepSeek과 같은 저비용 모델을 위한 결정론적 프로그램을 원합니다. LLM 부분은 결정론적이지 않겠지만, 품질을 이렇게 측정하는 것이 더 쉽습니다.” – 예산 모델을 사용한 재현 가능한 계획에 대한 수요를 강조합니다.

@Lalabadie: “다른 차별점을 찾기 위해 페이지를 열었지만, 프로젝트의 모든 내용(작성자 답변 포함)이 AI로 작성된 것처럼 보입니다.” – 프로젝트 문서가 강하게 AI 생성된 것으로 인식되어 신뢰에 영향을 줄 수 있음을 지적합니다.

@sharathr: “https://github.com/highflame-ai/codeoid를 시도해보셨나요?” – 비교를 위해 다른 코드 생성 도구를 제안합니다.

@ac‑ciano: “[dead]” – 원본 작성자의 댓글이 삭제되었음을 나타내며, 추가적인 통찰을 제공하지 않습니다.

플랫폼 지원 및 Windows 노트

표면 Linux macOS Windows
VS Code 확장 ✅ ✅ ✅
API 서버 ✅ ✅ ✅
CLI ✅ ✅ ✅
TUI (tmux 필요) ✅ ✅ WSL 필요
  • TUI는 작업별 터미널을 위해 tmux에 의존합니다. 패키지 매니저를 통해 설치하세요(apt install tmux, brew install tmux).
  • Windows에서는 대규모 시스템 프롬프트에서 .cmd 쉘 샤프의 제한을 피하기 위해 에이전트 CLI의 네이티브 설치 프로그램을 사용하세요.
  • 계획기의 읽기 전용 쉘 명령어(ls, grep 등)가 일관되게 작동하도록 Git for Windows가 설치되어 있는지 확인하세요.

아키텍처 요약

packages/
├─ core/      # 순수 TypeScript: Session, PlanStore, Planner, Orchestrator, VerdictEngine
├─ cli/       # TUI, plan/run/status 명령어, 얇은 터미널 드라이버
├─ vscode/    # 확장 UI, 스트리밍 계획 타임라인, 작업 카드
└─ web/       # Hono HTTP + WebSocket 데몬 (127.0.0.1:3742)

TUI의 핵심은 순수 리듀서이며, {state, effects}를 반환하고, 각 터미널 행에 하나의 문자열을 출력하는 렌더러를 갖습니다. 이로 인해 UI 로직은 테스트 가능하고 UI에 종속되지 않습니다.

라이선스

Ordewell은 Apache 라이선스 2.0 하에 배포됩니다. 이름과 로고는 NOTICE 파일에 따라 라이선스에서 제외됩니다.

Sources

관련

  • 프로젝트
    vercel-labs/coding-agent-template

    認証済みユーザーがAI駆動のコーディングタスク（Claude、Codex、Copilot、Cursor、Gemini、opencode）を作成できるVercelホスティングテンプレート。Vercel Sandboxを起動し、選択されたエージェントを実行、AI生成ブランチに変更をコミット、リアルタイムログを表示。Next.js 15、Tailwind、Neon Postgres、Vercel AI Gatewayで構築。マルチユーザーOAuth、ユーザー別APIキー、イテレーティブ作業向けのオプションサンドボックスKeep-Aliveをサポート。

  • 프로젝트
    OpenCoworkAI/open-cowork

    Open Cowork는 클로드 스타일(그리고 다른) LLM을 로컬 AI 에이전트 워크스페이스로 포장하는 무료 오픈소스 데스크톱 앱입니다. Windows/macOS용 원클릭 설치 프로그램, VM 수준의 사전 격리(WSL2/Lima), PPTX/DOCX/PDF/XLSX 파일 생성을 위한 내장된 '스킬' 시스템, 브라우저/노션용 MCP 커넥터, 그리고 페이슈 또는 슬랙을 통한 원격 제어를 통해 비기술 사용자가 자연어 명령으로 파일 읽기/쓰기, GUI 앱 자동화, 전문 문서 생성을 모두 로컬에서 실행하고, 선택적으로 VM 격리로 보안을 강화할 수 있습니다.

  • 프로젝트
    voocel/ainovel-cli

    ainovel-cli는 결정론적 엔진을 통해 여러 LLM 에이전트(Architect, Writer, Editor)를 조율하여 500장 이상의 장편 소설을 자동으로 작성하는 명령줄/TUI 도구입니다. 롤링 윈도우 계획, 계층적 요약, 체크포인트/복구, 다중 모델 지원, 임포트/익스포트, 구성 가능한 규칙을 갖추고 있으며, 헤드리스 또는 Docker에서 실행 가능합니다.

  • 프로젝트
    asheshgoplani/agent-deck

    Agent Deck은 Go로 작성된 터미널 UI로, 단일 창에서 여러 AI 코딩 에이전트(Claude, OpenCode, Codex, Pi 등)를 시작, 모니터링, 포크, 오케스트레이션할 수 있습니다. 그룹 기반 정책, 그룹별 Claude 자격 증명, MCP 도구 토글, 비용 대시보드, git-worktree 처리, 그리고 Telegram/Slack/Discord를 통해 쿼리할 수 있는 전화 제어 *conductor*를 추가합니다. 한 줄 스크립트, Homebrew 또는 `go install`로 설치한 다음 키보드 단축키(`Enter` 연결, `f` 포크, `$` 비용, `/` 검색 등)로 세션을 관리합니다.

  • 프로젝트
    FSoft-AI4Code/CodeWiki

    CodeWiki는 대규모 언어 모델을 사용하여 코드베이스 전체에 대한 포괄적이고 아키텍처를 고려한 문서(Markdown + Mermaid 다이어그램)를 자동 생성하는 오픈소스 Python 도구입니다. 10개 언어를 지원하며, 저장소를 계층적으로 분해하고 재귀적 멀티 에이전트 LLM 파이프라인을 실행하여 게시 가능한 문서를 출력합니다. 다양한 LLM 공급자와 풍부한 CLI를 지원합니다.