원문: truefoundry/trueforge · 수집일: 2026-08-23
핵심 요지
TrueForge는 TrueFoundry가 2026-07에 공개한 MIT 라이선스 오픈소스 에이전트 하네스다. “LLM을 동작하는 에이전트로 바꾸는 런타임 계층”을 표방하며, 에이전트 실행 루프(모델 호출, MCP 도구, skills, 샌드박싱, 승인, 컨텍스트 관리, 세션 상태)를 대신 돌려주고 그 결과를 채팅 UI / HTTP API + TypeScript SDK / 임베더블 UI SDK 세 가지로 노출한다. TypeScript로 작성됐고 스타 약 3.5천(수집 시점), 홈페이지는 trueforge.dev.
이 저장소는 harness 개념 — 모델 주위의 실행 scaffolding — 을 범용 제품으로 구현한 사례다. “에이전트를 만드는 건 쉽지만 잘 돌리는 건 어렵다”는 문제 의식이 README의 출발점이다.
주요 내용
- 카탈로그 기반 설정: models · MCP servers · skills · sandbox를 YAML 카탈로그로 한 번 정의하면 에이전트들이 선택해 재사용. 프리셋은 함께 배포되는 YAML을 커스터마이즈하는 방식.
- 모델 프로바이더 무관: OpenAI, Anthropic, Google Gemini 등 카탈로그 프로바이더 + 임의의 OpenAI 호환 엔드포인트.
- MCP 도구: header auth 또는 OAuth를 붙인 원격 MCP 서버 연결, 채팅 안에서의 인증 플로우 포함.
- Skills: git 기반
SKILL.md인스트럭션 팩을 샌드박스에서 필요할 때 로드. - Sandbox as a tool: 격리된 코드/파일 실행 환경(현재 Daytona, 확장 예정)을 필요 시점에만 프로비저닝하고 시크릿은 하네스가 보관.
- Human checkpoints: 도구 승인, ask-user-questions, Generative UI로 사람 개입 지점을 실행 루프에 내장.
- Context engineering: 서브에이전트, deferred tool loading, Code Mode, 대형 결과 offloading, compaction — harness 페이지가 정리한 컨텍스트 관리 기법들을 제품 기능으로 갖춤.
- 배포 스펙트럼: local 모드(단일 프로세스 + SQLite,
npx @truefoundry/trueforge)부터 hosted 모드(Postgres + Redis, Docker Compose/Helm)까지. 로컬 모드는 기본 로그인이 없어 localhost 전용이라고 명시. - 벤치마크 주장: 동일 작업·도구·모델에서 Claude Managed Agents와 deepagents 대비 “같은 정확도, 낮은 비용”을 주장하며
benchmark/에서 재현 가능하게 공개. 단 이 수치는 프로젝트 자기 주장이며 볼트에서 독립 검증은 하지 않았음(confidence: medium근거).
해석과 적용 메모
- 하네스 계층의 오픈소스 표준 후보. harness 개념 페이지의 “흥미로운 하네스 조합의 공간은 줄어들지 않는다”는 관점에서, Claude Code류 코딩 하네스와 달리 범용 채팅 에이전트 인프라(승인·세션·UI 포함)를 표준화하려는 시도로 읽힌다.
- MCP + skills + 샌드박스 조합은 moc-mcp의 도구 생태계 위에서 자체 호스팅 에이전트 플랫폼을 만들 때 참조 가치가 큼. 특히 “카탈로그로 리소스를 한 번 정의 → 여러 에이전트가 소비” 구조는 조직 차원 에이전트 거버넌스 관점과 맞닿는다.
- 벤치마크는 재현 코드가 공개돼 있으니 실제 도입 검토 시
benchmark/를 직접 돌려 확인할 것.
누락·접근 제한
- GitHub API로 README 전문과 저장소 메타데이터만 수집. docs 사이트 본문과 소스 코드, 벤치마크 실측값은 미확인.
- README 내 hero/architecture 이미지는 수집하지 않음(임베드 불필요).
관련 노트
- moc-ai-agents-harness — 하네스 설계 MOC
- harness — 에이전트 하네스 아키텍처 개념
- moc-mcp — MCP 도구 생태계 MOC