Flue
Flue is a TypeScript agent harness framework for building headless, programmable AI agents that deploy anywhere — Node.js, Cloudflare, GitHub Actions, and more.
At a Glance
Fully free and open-source under the Apache License 2.0. Use, modify, and distribute freely.
Engagement
Available On
Listed May 2026
About Flue
Flue is a TypeScript framework for building the next generation of AI agents, designed around a built-in agent harness. It is runtime-agnostic — think Astro or Next.js, but for agents — letting you write once and deploy to Node.js, Cloudflare Workers, GitHub Actions, GitLab CI/CD, and more. Agents are fully headless and programmable with no TUI, no GUI, and no assumption of a human operator. Most agent logic lives in Markdown (skills, context, and AGENTS.md), keeping TypeScript code minimal.
- Agent Harness Framework: Build agents that act autonomously to solve problems and complete tasks, modeled after the familiar Claude Code / OpenCode / Codex developer experience but 100% headless.
- Virtual Sandbox by Default: Powered by just-bash, the built-in virtual sandbox is faster, cheaper, and more scalable than full containers — ideal for high-traffic agents.
- Container Sandbox Support: Opt into real Linux environments via connectors (e.g., Daytona) for full coding agents with git, Node.js, a browser, and a cloned repo.
- Skills & Roles: Define reusable agent skills in Markdown and assign roles at the agent, session, or per-call level for fine-grained orchestration.
- Session & Task Management: Persist message history and sandbox state across requests; use
session.task()for focused one-shot child agents with their own message history. - MCP Tool Integration: Connect to remote MCP servers at runtime via
connectMcpServer(), keeping secrets inenvrather than prompts or filesystem context. - Typed Results: Pass a Valibot schema to
session.prompt()orsession.skill()to get schema-validated, typed data back from any agent call. - CLI Tooling: Use
flue devfor a watch-mode dev server,flue runfor one-shot CI invocations, andflue buildto produce deployable artifacts for Node.js or Cloudflare. - Multi-Model Support: Works with Anthropic Claude, OpenAI, Google Gemini, Moonshot Kimi, and any model available via OpenRouter.
- Open Source: Licensed under Apache 2.0 — free to use, modify, and distribute.
Community Discussions
Be the first to start a conversation about Flue
Share your experience with Flue, ask questions, or help others learn from your insights.
Pricing
Open Source
Fully free and open-source under the Apache License 2.0. Use, modify, and distribute freely.
- Full agent harness framework
- Virtual and container sandbox support
- CLI tooling (flue dev, flue run, flue build)
- Multi-model support
- MCP integration
Capabilities
Key Features
- Agent harness framework
- Virtual sandbox (just-bash powered)
- Container sandbox support via connectors
- Skills defined in Markdown
- Roles and subagents
- Session persistence and task delegation
- Remote MCP server integration
- Typed schema-validated results (Valibot)
- CLI: flue dev, flue run, flue build
- Multi-model support (Anthropic, OpenAI, Gemini, OpenRouter)
- Deploy to Node.js, Cloudflare Workers, GitHub Actions, GitLab CI/CD
- Durable Objects-backed session state on Cloudflare
- Custom virtual sandbox support
- Environment variable loading via --env flag
