Repolode
제출하기
thruwire

thruwire/foreman

Codex와 OpenCode 같은 코딩 에이전트를 의사결정 모델로 감시해 작업 완료 여부, 테스트의 충분성, 작업자 정체 여부를 평가하는 Python 감독 도구입니다.

GitHub에서 보기웹사이트
스타
814
포크
69
열린 이슈
10
마지막 커밋
23일 전

어떤 프로젝트인가요?

Foreman은 AI 코딩 에이전트를 감독하는 도구입니다. 티켓, 명세 또는 버그 리포트를 전달하면 Codex, OpenCode, Hermes 또는 LangChain의 Deep Agents CLI 같은 작업자를 실행합니다. 작업자가 실행되는 동안 Foreman은 작업 내용, git 상태와 diff, 출력 끝부분, 테스트 결과, 저장소의 AGENTS.md 지침 등 범위가 제한된 근거를 주기적으로 의사결정 모델에 전달합니다. 모델은 구현 완료도, 요구사항 충족 여부, 검증 필요성, 작업자의 정체 또는 이탈 여부 같은 항목의 확률을 반환합니다.

결정론적인 Python 정책이 이 점수를 바탕으로 계속 진행, 작업 진행 중 작업자 조정(Codex App Server만 지원), 중단, 재시도, 검증자 시작, 완료 처리 또는 사람에게 에스컬레이션 등의 행동을 결정합니다. 책임 범위는 임계값을 설정할 수 있는 TOML 파일로 정의하며, 사용자 지정 검사도 추가할 수 있습니다. 의사결정 모델은 TypeSafe의 Jev(기본값) 또는 OpenAI의 Decisions API를 사용할 수 있습니다.

Foreman은 Codex, Deep Agents, Pi용 훅을 통해 대화형 세션에 감독 기능을 연결하는 것도 지원합니다. API 키 없이 결정론적 데모를 실행할 수 있으며, 실행 상태는 각 저장소의 .foreman 디렉터리에 로컬로 저장됩니다.

핵심 기능

  • 01Codex, OpenCode, Hermes 또는 Deep Agents를 코딩 작업자로 실행합니다.
  • 02작업자와 독립적으로 완료 여부, 요구사항 충족 여부, 테스트의 충분성, 작업자 상태를 평가합니다.
  • 03진행 중인 Codex 턴을 조정하거나 정체된 작업자를 중단하고 재시도할 수 있습니다.
  • 04Jev 및 OpenAI 의사결정 모델 어댑터를 지원합니다.
  • 05TOML에서 책임 범위, 임계값, 외부 근거 수집 명령을 설정할 수 있습니다.

활용 사례

  • 무인 코딩 에이전트가 반복 작업에 빠지거나 티켓의 범위를 벗어나지 않도록 합니다.
  • 에이전트 결과를 수락하기 전에 완료 여부와 테스트 커버리지를 독립적으로 확인합니다.
  • 개발자가 시작한 대화형 Codex 또는 Pi 세션을 감독합니다.
  • 사용자 지정 검사를 통해 코딩 에이전트의 의미 기반 감독을 실험합니다.

빠른 시작

  1. 1

    기본 Jev 의사 결정 모델에 사용할 TYPESAFE_API_KEY 환경 변수를 설정합니다

  2. 2

    작업 설명이 있는 프로젝트에서 OpenCode 워커 백엔드를 사용해 Foreman을 실행합니다

    FOREMAN_WORKER_BACKEND=opencode foreman run --repo ./my-project --job "Add request retries"

사용 전 알아둘 점

  • Foreman은 현재 코딩 워커를 한 번에 하나만 실행합니다.
  • 활성 턴에 대한 실시간 조정은 Codex App Server 백엔드에서만 작동합니다. 다른 백엔드에서는 중지 후 재시도로 대체됩니다.
  • 기본 의사 결정 모델을 설정하려면 TYPESAFE_API_KEY가 필요합니다.

포함된 컬렉션

오픈소스 AI 에이전트 프레임워크와 앱AI 코딩 어시스턴트와 에이전트

토픽

#ai-agents#coding-agent#llm#agent-supervision#code-review#automation#python#codex#jev#opencode

자주 묻는 질문

foreman은(는) 무엇인가요?
Codex와 OpenCode 같은 코딩 에이전트를 의사결정 모델로 감시해 작업 완료 여부, 테스트의 충분성, 작업자 정체 여부를 평가하는 Python 감독 도구입니다. Foreman은 AI 코딩 에이전트를 감독하는 도구입니다. 티켓, 명세 또는 버그 리포트를 전달하면 Codex, OpenCode, Hermes 또는 LangChain의 Deep Agents CLI 같은 작업자를 실행합니다. 작업자가 실행되는 동안 Foreman은 작업 내용, git 상태와 diff, 출력 끝부분, 테스트 결과, 저장소의 AGENTS.md 지침 등 범위가 제한된 근거를 주기적으로 의사결정 모델에 전달합니다. 모델은 구현 완료도, 요구사항 충족 여부, 검증 필요성, 작업자의 정체 또는 이탈 여부 같은 항목의 확률을 반환합니다.
foreman은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
foreman은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
foreman은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. foreman의 마지막 커밋은 2026년 10월 15일입니다.
foreman은(는) 어디에 사용할 수 있나요?
무인 코딩 에이전트가 반복 작업에 빠지거나 티켓의 범위를 벗어나지 않도록 합니다. 에이전트 결과를 수락하기 전에 완료 여부와 테스트 커버리지를 독립적으로 확인합니다. 개발자가 시작한 대화형 Codex 또는 Pi 세션을 감독합니다. 사용자 지정 검사를 통해 코딩 에이전트의 의미 기반 감독을 실험합니다.
foreman는 어떻게 설치하나요?
기본 Jev 의사 결정 모델에 사용할 TYPESAFE_API_KEY 환경 변수를 설정합니다 작업 설명이 있는 프로젝트에서 OpenCode 워커 백엔드를 사용해 Foreman을 실행합니다: FOREMAN_WORKER_BACKEND=opencode foreman run --repo ./my-project --job "Add request retries"
foreman은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/thruwire/foreman

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트