Flue Agent Framework

What does this agent do, and when should you use it?

Flue is a TypeScript harness framework for autonomous agents, deliberately positioned as more than an SDK. A developer writes one exported function, declares the model with useModel, a sandbox with useSandbox, reusable expertise with useSkill and typed actions with useTool, then returns a plain-language task instruction — the function itself is the agent. The runtime supplies sessions, tools, skills, filesystem access and virtual, local or remote container sandboxes, plus durable recovery for accepted work, subagents, MCP tool connections and verified event channels. It ships as @flue/runtime, @flue/vite, @flue/cli, @flue/sdk, @flue/opentelemetry and @flue/postgres, and deploys to Node.js, Cloudflare Workers, GitHub Actions, GitLab CI/CD, Daytona and Render. Observability can flow to OpenTelemetry, Braintrust, Sentry or a custom observer.

Agent files under agents/ use the 'use agent' directive and call useModel to pick a model, useSandbox to attach an environment such as local() from @flue/runtime/node, useSkill to load SKILL.md skill documents, and useTool to register typed tool functions like openIssue or searchCode; the returned string becomes the agent's operating instruction. At runtime the harness assembles context, loads skills and tools, lets the model read and write files and call tools inside the sandbox, and keeps progressing toward the goal across conversation turns and events, with durable recovery of accepted work after failures or restarts. It connects to MCP Servers for authenticated tools, receives verified events from Slack, Teams, Discord and GitHub through Channels, runs locally with the flue CLI, and is built and served via @flue/vite. Deployed conversations are consumed with @flue/sdk, and @flue/postgres provides persistence.

1. Bug-triage teams that want an agent to reproduce an issue, find the root cause, check intent and attempt a fix inside a sandbox
2. Platform teams piping verified Slack, Discord or GitHub events into autonomous workflows through Channels
3. Engineering teams deploying an agent service on Node.js or Cloudflare Workers and wiring a frontend through @flue/sdk
4. Long-running jobs that need durable sessions and recovery, with persistence via @flue/postgres
5. Developers structuring complex work as specialized subagents that the main agent delegates to

How do you install or deploy this agent?

The README does not document a full install or scaffolding sequence (no package-manager install or init command is shown). The documented packages are @flue/runtime, @flue/vite, @flue/cli, @flue/sdk, @flue/opentelemetry and @flue/postgres; a Node.js runtime and credentials for your chosen model provider are required. The agent file itself is written as follows:

// agents/triage.ts
'use agent';
import { useModel, useSandbox, useSkill, useTool } from '@flue/runtime';
import { local } from '@flue/runtime/node';
import triage from '../skills/triage/SKILL.md';
import verify from '../skills/verify/SKILL.md';
import { openIssue, searchCode } from '../tools/github.ts';

export function Triage() {
  useModel('anthropic/claude-sonnet-4-6');
  useSandbox(local());
  useSkill(triage);
  useSkill(verify);
  useTool(openIssue);
  useTool(searchCode);

  return `Triage a bug report end-to-end: reproduce the bug,
diagnose the root cause, verify whether the behavior is
intentional, and attempt a fix.`;
}

How do you use this agent?

After composing the agent function, run it locally with the flue CLI or serve and build it with the @flue/vite plugin:

vite dev

vite build

The flue binary provides local runs, blueprints and offline docs:

flue

For deployment, the README lists Node.js, Cloudflare Workers, GitHub Actions, GitLab CI/CD, Daytona and Render. Consume deployed conversations with @flue/sdk and export traces with @flue/opentelemetry.

What are this agent's strengths and limitations?

How does this agent compare with similar options?

Key facts side by side with the most closely related agents.

How does FollowAgents rate this agent?

Recent releases

Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.

1. @flue/[email protected] 2026-09-28
   Release notes excerpt

   Patch Changes - Updated dependencies [2cb57be] - @flue/[email protected]

   View on GitHub ↗
2. @flue/[email protected] 2026-09-28
   Release notes excerpt

   Patch Changes - Updated dependencies [2cb57be] - @flue/[email protected]

   View on GitHub ↗
3. @flue/[email protected] 2026-09-28
   Release notes excerpt

   Patch Changes - Updated dependencies [2cb57be] - @flue/[email protected]

   View on GitHub ↗

FAQ