# Flue - 샌드박스 에이전트 프레임워크

> Clean Markdown view of GeekNews topic #29849. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=29849](https://news.hada.io/topic?id=29849)
- GeekNews Markdown: [https://news.hada.io/topic/29849.md](https://news.hada.io/topic/29849.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2026-05-25T10:01:02+09:00
- Updated: 2026-05-25T10:01:02+09:00
- Original source: [flueframework.com](https://flueframework.com/)
- Points: 7
- Comments: 0

## Topic Body

- **TypeScript 기반 에이전트 하네스 프레임워크**로, Claude Code·Codex 같은 코딩 에이전트의 사용 경험을 **100% 헤드리스·프로그래머블** 방식으로 재구성  
- 사용자가 구축한 에이전트가 클로드 코드를 사용하는 것처럼 자율적으로 문제를 해결하고 작업 완료  
- **Agent = Model + Harness**: 단순 챗봇부터 전체 코딩 플랫폼까지 모든 자율 에이전트/워크플로우 표현 가능  
  - 계획·컨텍스트 수집·파일 작성·서브에이전트 생성·역할 채택·문제 해결 가능  
  - Claude Code, Codex를 강력하게 만드는 **하네스 아키텍처**를 일반화  
- TUI/GUI나 사람 운영자 가정 없이 **순수 TypeScript 코드**만으로 자율 에이전트 구성, 로직 대부분은 Markdown(skills, context, AGENTS.md)으로 작성  
- **4계층 모던 에이전트 아키텍처**   
  - 01 **Model** (tokens · tools · prompts)  
  - 02 **Harness** (skills · memory · sessions)  
  - 03 **Sandbox** (bash · security · network)  
  - 04 **Filesystem** (read · write · grep · glob)  
- **런타임 비종속(runtime-agnostic) 구조**로 Node.js, Cloudflare Workers, GitHub Actions, GitLab CI/CD 등 어디서나 동일 코드로 빌드·배포  
- 배포 시 에이전트를 **HTTP 서버로 번들링**, 또는 서버 없이 CLI에서 직접 실행해 로컬·CI 작업에 활용  
- 기본 동작은 `vercel-labs/just-bash` 기반의 **가상 샌드박스**, 매 에이전트마다 컨테이너를 띄우지 않아 고트래픽 환경에서 빠르고 저렴하게 확장 가능  
  - 원격 샌드박스(Daytona 등) 연결 또는 **제로 컨피그 내장 가상 샌드박스** 선택 가능  
- 주요 API: `init()`, `harness.session()`, `session.skill()`(구조화된 출력), `session.prompt()`, `session.shell()`, `session.fs.writeFile()`  
- **민감한 토큰·API 키 분리 보호** 가능, 에이전트/샌드박스가 GITHUB_TOKEN 등을 직접 보지 못하도록 env 제어  
- 에이전트·하네스·샌드박스 **전체 스택을 직접 소유**, "다른 사람의 에이전트를 임대하지 말라"  
- Astro·Next.js가 웹 앱을 표준화한 방식처럼, **에이전트 개발의 표준 프레임워크** 지향 (현재 Experimental, API 변경 가능)  
- 클로드코드/코덱스에게 `fetch https://flueframework.com/start.md to create a new agent` 해서 새 에이전트 개발 시작   
- Apache-2.0 라이선스

## Comments



_No public comments on this page._