Flue, 에이전트 하네스를 TypeScript 프레임워크로 묶다

“또 하나의 AI SDK”가 아니라 프레임워크를 주장한다

Flue는 홈페이지에서 자신을 The Agent Harness Framework라고 소개한다. GitHub 저장소 withastro/flue의 README도 같은 방향이다. Claude Code, Codex, Gemini 같은 도구를 써본 개발자라면 에이전트의 기본 경험을 안다는 전제에서, 그 경험을 TUI나 GUI 없이 TypeScript 코드로 프로그래밍 가능하게 만들겠다는 것이다.

Hacker News의 토론에서도 관심이 모인 이유는 명확하다. 개발자들은 이제 “LLM API를 호출하는 함수”보다 “에이전트가 장기 세션, 도구, 샌드박스, 결과 스키마를 어떻게 다루는가”를 묻고 있다. Flue는 이 질문에 Next.js나 Astro 같은 웹 프레임워크의 문법을 빌려 답하려 한다.

Flue가 묶으려는 구성요소

README 기준 Flue의 주요 패키지는 @flue/sdk, @flue/cli, @flue/connectors다. 예제는 webhook 트리거, 세션, valibot 결과 스키마, Cloudflare R2를 파일시스템처럼 마운트하는 지원 에이전트, GitHub Actions에서 gh와 npm을 제한적으로 연결하는 triage 에이전트를 보여준다. start.md는 새 에이전트를 만들 때 README와 홈페이지를 먼저 읽고, 배포 대상과 모델 ID를 명시하도록 안내한다.

이런 방향은 Mendral의 샌드박스 밖 하네스 논의와 맞닿아 있다. Mendral이 운영 아키텍처를 설명한다면, Flue는 개발자가 그런 하네스를 구현할 때 필요한 추상화를 제공하려 한다.

가상 샌드박스와 로컬 권한의 균형

Flue README에서 눈에 띄는 대목은 기본적으로 컨테이너를 매번 띄우지 않고 just-bash 기반 가상 샌드박스를 쓸 수 있다는 점이다. 고트래픽 에이전트에서 모든 요청마다 완전한 컨테이너를 만들면 비용과 지연이 커진다. 반면 CI triage처럼 실제 저장소, git, gh, npm이 필요한 경우에는 로컬 샌드박스를 마운트하고 명령을 제한적으로 연결한다.

이 균형은 중요하다. VS Code의 Copilot 공동저자 논란이 보여주듯 개발 도구는 작은 기본값도 신뢰 이슈가 된다. 에이전트 프레임워크는 더 큰 권한을 다룬다. 어떤 명령에 어떤 환경변수를 줄지, 어떤 파일시스템을 마운트할지, 모델이 어떤 결과 스키마를 만족해야 하는지 코드 레벨에서 표현할 수 있어야 한다.

한국 개발팀이 볼 포인트

TypeScript 생태계 팀에는 Flue식 접근이 익숙할 수 있다. 라우트, 미들웨어, 세션, 빌드, 배포를 하나의 프레임워크가 묶어주는 웹 개발 경험과 비슷하기 때문이다. 에이전트도 결국 고객 지원, 내부 운영, 코드 리뷰, 데이터 분석 같은 제품 기능으로 들어온다. 그러면 “프롬프트 파일 몇 개”가 아니라 배포 가능한 소프트웨어 단위가 필요하다.

다만 초기 프로젝트라는 점도 분명하다. GitHub API 조회 시점 기준 저장소는 2026년 2월 만들어졌고, README에는 실험적이며 API가 바뀔 수 있다고 적혀 있다. 따라서 당장 미션 크리티컬 워크로드를 맡기기보다는 내부 도구, CI 보조, 고객 지원 초안처럼 위험이 낮고 효과 측정이 쉬운 영역에서 검증하는 편이 좋다. Structured Output Benchmark가 보여준 것처럼 결과 스키마와 검증은 프로덕션 LLM의 기본 안전장치가 된다.

프레임워크 경쟁의 다음 라운드

AI 앱 개발은 LangChain식 체이닝에서 모델별 SDK, MCP 도구 연결을 지나 에이전트 하네스 프레임워크로 이동 중이다. Flue의 가치는 모델 호출 추상화보다 “에이전트가 일을 끝낼 때까지 안전하게 반복하는 런타임”에 있다. 이 계층을 누가 잡느냐가 앞으로 AI 개발자 경험의 표준을 정할 가능성이 크다.

FAQ

Q1. Flue는 어떤 언어 프레임워크인가?
TypeScript 기반이다. 에이전트 핸들러, 트리거, 세션, 결과 스키마를 코드로 정의한다.

Q2. 기존 AI SDK와 무엇이 다른가?
단순 모델 호출이 아니라 샌드박스, 도구, 스킬, 세션, 배포를 함께 다루는 하네스 프레임워크를 지향한다.

Q3. 어느 환경에 배포할 수 있나?
README와 시작 문서는 Node.js, Cloudflare, GitHub Actions, GitLab CI/CD 등을 예로 든다.

Q4. 모델은 자동으로 고르나?
아니다. 문서에서는 init({ model })에 명시적인 모델 ID를 넣도록 안내한다.

Q5. 지금 바로 도입해도 되나?
실험적 프로젝트이므로 내부 파일럿부터 시작하는 것이 안전하다.