Skip to content

withastro/flue

Flue — The Agent Harness Framework

Not another SDK. Build autonomous agents with Flue's programmable TypeScript harness.

// 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';

// The agent IS the function. Compose the complete harness it needs to do
// real work, complete with virtual, local, or remote container sandbox.
export function Triage() {
  useModel('anthropic/claude-sonnet-4-6');
  useSandbox(local());
  useSkill(triage);
  useSkill(verify);
  useTool(openIssue);
  useTool(searchCode);

  // Give agents the context and autonomy to solve complex tasks:
  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.

...`;
}

The framework for building the next generation of agents.

The first agents were built with raw LLM API calls. This worked for simple chatbots and scripted tasks, but not much else.

Agents like Claude Code and Codex broke the mold. These were real agents. Autonomous. You give them a task — not a pre-defined series of steps — and trust them to complete it using the context and tools that you provide.

Flue unlocks this new architecture for agents. Its built-in TypeScript harness gives any model the context and environment it needs for truly autonomous work: sessions, tools, skills, instructions, filesystem access, and a secure sandbox to run in. Run your agents locally via CLI or deploy them to your hosted runtime of choice.

Features

Build agents that can safely take action, maintain continuity, and connect to the systems where work already happens.

  • Agents — Build agents that can keep context across conversations and events as they autonomously work toward a goal.
  • Sandboxes — Give agents a secure environment where they can use tools, modify files, and autonomously complete real work.
  • Durability — Learn how agents preserve progress through failures and restarts with durable recovery for accepted work.
  • Subagents — Define specialized roles for different tasks, then let your agent delegate work to the right expert.
  • Tools — Give agents typed actions for calling APIs, querying data, and making controlled changes through your application.
  • Skills — Package reusable expertise and workflows that agents can load whenever a task needs specialized guidance.
  • MCP Servers — Connect agents to authenticated tools and services through the open Model Context Protocol ecosystem.
  • Observability — Monitor your agents and export telemetry with OpenTelemetry, Braintrust, Sentry, or your own observer.
  • Channels — Receive verified events from Slack, Teams, Discord, GitHub, and more.

Deploy Anywhere

Packages

Package Description
@flue/runtime Runtime: harness, sessions, tools, sandbox
@flue/vite Vite plugin: vite dev / vite build for Node and Cloudflare
@flue/cli CLI (flue binary): local runs, blueprints, offline docs
@flue/sdk Client SDK for consuming deployed agent conversations
@flue/opentelemetry OpenTelemetry tracing adapter
@flue/postgres Postgres persistence adapter

Contributors

Languages