Flue는 Astro 개발팀(withastro)이 제작한 TypeScript 기반 에이전트 하네스(agent harness) 프레임워크다. “Claude Code를 헤드리스·프로그래머블하게 만든 것”을 목표로, 에이전트 로직 대부분을 Markdown(skills, context, AGENTS.md)으로 선언하고 실제 코드는 최소화한다. Node.js, Cloudflare Workers, GitHub Actions, GitLab CI/CD 등 어디서나 배포 가능한 런타임 불가지론적 설계가 특징이다. 현재 실험적(Experimental) 단계로 활발히 개발 중이다.

설계 철학

Flue의 핵심 아이디어는 “로직을 코드가 아닌 Markdown으로”다. 에이전트의 동작 방식·컨텍스트·스킬을 .md 파일에 선언하고, TypeScript 파일은 트리거와 입출력 스키마만 정의한다. Astro가 프레임워크 없는 웹 컴포넌트를 지향하듯, Flue는 특정 런타임이나 LLM에 종속되지 않는 에이전트 개발 방식을 제시한다.

주요 구성 요소

패키지

샌드박스

• just-bash 기반 가상 샌드박스: 컨테이너 없이도 빠르고 저렴하게 에이전트 실행
• Daytona 연동: 실제 Linux 환경이 필요할 때 컨테이너 샌드박스로 전환

지원 모델

모델을 자유롭게 교체할 수 있다:

anthropic/claude-opus-4-7
anthropic/claude-sonnet-4-6
openrouter/moonshotai/kimi-k2.6
openai/gpt-5.5

코드 예시

import type { FlueContext } from '@flue/sdk/client';
import * as v from 'valibot';

export const triggers = { webhook: true };

export default async function ({ init, payload }: FlueContext) {
  const agent = await init({
    model: 'anthropic/claude-sonnet-4-6'
  });

  const session = await agent.session();

  const result = await session.prompt(
    `이슈를 분류하고 담당자를 지정하라: ${payload.issue}`,
    {
      result: v.object({
        category: v.string(),
        assignee: v.string(),
        priority: v.picklist(['high', 'medium', 'low'])
      })
    }
  );

  return result;
}

result 스키마로 LLM 출력을 타입 안전하게 파싱한다.

주요 특징

• 런타임 불가지론: Node.js / Cloudflare / GitHub Actions / GitLab CI/CD 모두 지원
• Markdown 우선 로직: skills·context·AGENTS.md로 동작 선언 → TypeScript 코드 최소화
• valibot 스키마 검증: 결과 구조화 및 타입 안전성 보장
• 가상 샌드박스: just-bash 기반, 컨테이너 없이 빠른 실행

누가 사용하면 좋은가

• Claude Code 스타일의 에이전트를 프로그래머블하게 구축하고 싶은 TypeScript 개발자
• CI/CD 파이프라인에 에이전트를 통합하려는 팀 (코드 리뷰 자동화, 이슈 트리아지 등)
• 특정 LLM이나 런타임에 종속되지 않는 에이전트 인프라가 필요한 경우

라이선스 및 링크

• GitHub: https://github.com/withastro/flue
• 상태: 실험적 (Experimental)

관련 문서

• agent-harness — 에이전트 하네스 엔지니어링 방법론
• claude-agent-sdk — Claude Agent SDK로 프로덕션 에이전트 구축
• halo — RLM 기반 에이전트 하네스 자동 최적화 루프
• everything-claude-code — Claude Code 기반 에이전트 하네스 성능 최적화 시스템