# Flue & Eve Agent Frameworks Documentation > Source-grounded reference for two TypeScript agent harness frameworks: Flue (programmable harness, multi-target deploy) and Eve (filesystem-first durable agents on Vercel). Covers workspace setup, authoring models, HTTP protocols, CLI commands, and deployment paths. This is a Grok-Wiki source-grounded repository documentation set. Use the complete Markdown link when an agent needs the full repo context. ## Context Links - [Complete Markdown docs](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/llms-full.txt) - [Complete Markdown alias](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6.md) - [Human interactive docs](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6) - [GitHub repository](https://github.com/withastro/flue) ## Repository - Repository: withastro/flue-with-vercel-eve - Generated: 2026-06-18T19:31:09.220Z - Updated: 2026-06-18T19:31:14.049Z - Runtime: Grok CLI - Format: Documentation - Pages: 22 ## Pages - [Overview](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/01-overview.md): What Flue and Eve expose, how the workspace repos relate, runtime assumptions, and the shortest source-backed paths into each framework. - [Installation](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/02-installation.md): Prerequisites, package managers, Node engine requirements, and first-install commands for Flue and Eve projects. - [Flue quickstart](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/03-flue-quickstart.md): Scaffold a Flue project, run `flue dev`, invoke a workflow with `flue run`, and connect to an agent instance with `flue connect`. - [Eve quickstart](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/04-eve-quickstart.md): Run `eve init`, start `eve dev`, inspect discovery with `eve info`, and send the first session message to the stable HTTP API. - [Flue project layout](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/05-flue-project-layout.md): Source-root resolution (`.flue/` vs `src/`), agent and workflow modules, `app.ts` composition, and discovery boundaries. - [Eve project layout](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/06-eve-project-layout.md): Authored slots under `agent/`, path-derived naming, workspace seeding rules, and subagent package boundaries. - [Runtime models](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/07-runtime-models.md): Compare Flue sessions, workflow runs, and dispatch receipts with Eve sessions, turns, `continuationToken`, and `sessionId` contracts. - [Build Flue agents](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/08-build-flue-agents.md): Author agents with `createAgent`, `defineAgentProfile`, tools, skills, sandboxes, providers, and HTTP route handlers. - [Flue workflows](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/09-flue-workflows.md): Define workflow modules, initialize agents inside `run()`, invoke via CLI or HTTP, and inspect run events with `flue logs`. - [Flue channels](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/10-flue-channels.md): Discover channel modules, mount verified webhook routes under `/channels/:name`, and dispatch inbound events to agents. - [Flue deploy](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/11-flue-deploy.md): Choose Node or Cloudflare targets, register providers in `app.ts`, build artifacts with `flue build`, and apply blueprint-driven integrations. - [Eve authoring surfaces](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/12-eve-authoring-surfaces.md): Configure `agent.ts`, write instructions, tools, skills, connections, sandbox overrides, subagents, and schedules from the filesystem contract. - [Eve sessions and streaming](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/13-eve-sessions-and-streaming.md): Start sessions, stream NDJSON events, send follow-ups with `continuationToken`, and handle HITL, subagent, and compaction events. - [Eve deployment](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/14-eve-deployment.md): Build `.eve/` artifacts, configure Vercel env and sandbox backends, prewarm templates, deploy, and verify production routes. - [Flue CLI reference](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/15-flue-cli-reference.md): Commands, flags, defaults, and exit behavior for `flue dev`, `run`, `connect`, `build`, `init`, `add`, `update`, `docs`, and `logs`. - [Flue configuration reference](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/16-flue-configuration-reference.md): `flue.config.*` keys (`target`, `root`, `output`), source-root precedence, env loading, and CLI override rules. - [Flue HTTP API reference](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/17-flue-http-api-reference.md): Mounted routes (`/agents`, `/workflows`, `/runs`, `/channels`, `/openapi.json`), admission semantics, stream reads, and error envelopes. - [Flue persistence reference](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/18-flue-persistence-reference.md): `PersistenceAdapter` contract, store interfaces, built-in database adapters, and `db.ts` discovery for durable execution. - [Eve CLI reference](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/19-eve-cli-reference.md): Commands and flags for `eve init`, `info`, `build`, `start`, `dev`, `link`, `deploy`, `eval`, and `channels` subcommands. - [Eve HTTP protocol reference](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/20-eve-http-protocol-reference.md): Session routes, NDJSON event types, `continuationToken` follow-ups, stream reconnect rules, and client integration entry points. - [Flue examples](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/21-flue-examples.md): Copy-pasteable fixtures for hello-world workflows, channel ingress, observability adapters, and target-specific integrations. - [Eve weather fixture](https://www.grok-wiki.com/public/docs/withastro-flue-with-vercel-eve-f4b79875fff6/pages/22-eve-weather-fixture.md): Walk through the `weather-agent` fixture: instructions, tool schema, skill procedure, and local dev smoke paths. ## Source Files - `vercel-eve:.nvmrc` - `vercel-eve:apps/fixtures/weather-agent/agent/agent.ts` - `vercel-eve:apps/fixtures/weather-agent/agent/instructions.md` - `vercel-eve:apps/fixtures/weather-agent/agent/skills/get-weather.md` - `vercel-eve:apps/fixtures/weather-agent/agent/tools/get_weather.ts` - `vercel-eve:apps/fixtures/weather-agent/package.json` - `vercel-eve:apps/fixtures/weather-agent/README.md` - `vercel-eve:Dockerfile` - `vercel-eve:docs/agent-config.md` - `vercel-eve:docs/channels/overview.mdx` - `vercel-eve:docs/concepts/default-harness.md` - `vercel-eve:docs/concepts/execution-model-and-durability.md` - `vercel-eve:docs/concepts/sessions-runs-and-streaming.md` - `vercel-eve:docs/connections.mdx` - `vercel-eve:docs/getting-started.mdx` - `vercel-eve:docs/guides/auth-and-route-protection.md` - `vercel-eve:docs/guides/deployment.md` - `vercel-eve:docs/guides/frontend/overview.mdx` - `vercel-eve:docs/guides/instrumentation.md` - `vercel-eve:docs/guides/session-context.md` - `vercel-eve:docs/introduction.md` - `vercel-eve:docs/meta.json` - `vercel-eve:docs/README.md` - `vercel-eve:docs/reference/cli.md` - `vercel-eve:docs/reference/project-layout.md` - `vercel-eve:docs/reference/typescript-api.md` - `vercel-eve:docs/sandbox.mdx` - `vercel-eve:docs/skills.mdx` - `vercel-eve:docs/subagents.mdx` - `vercel-eve:docs/tools.mdx` - `vercel-eve:package.json` - `vercel-eve:packages/eve/package.json` - `vercel-eve:packages/eve/src/public/index.ts` - `vercel-eve:packages/eve/src/public/tools/index.ts` - `vercel-eve:pnpm-workspace.yaml` - `vercel-eve:README.md` - `vercel-eve:scripts/dev.mjs` - `vercel-eve:turbo.json` - `withastro-flue:AGENTS.md` - `withastro-flue:blueprints/channel.md` - `withastro-flue:blueprints/database.md` - `withastro-flue:CHANGELOG.md` - `withastro-flue:examples/braintrust/README.md` - `withastro-flue:examples/braintrust/src/workflows/task.ts` - `withastro-flue:examples/cloudflare/src/workflows/skills-from-r2.ts` - `withastro-flue:examples/github-channel/src/channels/github.ts` - `withastro-flue:examples/hello-world/flue.config.ts` - `withastro-flue:examples/hello-world/src/agents/session-test.ts` - `withastro-flue:examples/hello-world/src/app.ts` - `withastro-flue:examples/hello-world/src/workflows/hello.ts` - `withastro-flue:examples/hello-world/src/workflows/with-subagent.ts` - `withastro-flue:examples/imported-skill/README.md` - `withastro-flue:examples/notion-channel/README.md` - `withastro-flue:examples/react-chat/flue.config.ts` - `withastro-flue:examples/slack-channel/src/channels/slack.ts` - `withastro-flue:knip.json` - `withastro-flue:package.json` - `withastro-flue:packages/cli/bin/flue.ts` - `withastro-flue:packages/cli/package.json` - `withastro-flue:packages/cli/src/lib/build.ts` - `withastro-flue:packages/cli/src/lib/config-paths.ts` - `withastro-flue:packages/cli/src/lib/config.ts` - `withastro-flue:packages/cli/src/lib/dev.ts` - `withastro-flue:packages/cli/src/lib/env.ts` - `withastro-flue:packages/cli/src/lib/source-root.ts` - `withastro-flue:packages/github/src/index.ts` - `withastro-flue:packages/libsql/README.md` - `withastro-flue:packages/mysql/README.md` - `withastro-flue:packages/postgres/README.md` - `withastro-flue:packages/postgres/src/index.ts` - `withastro-flue:packages/runtime/src/adapter.ts` - `withastro-flue:packages/runtime/src/agent-definition.ts` - `withastro-flue:packages/runtime/src/errors.ts` - `withastro-flue:packages/runtime/src/index.ts` - `withastro-flue:packages/runtime/src/runtime/flue-app.ts` - `withastro-flue:packages/runtime/src/runtime/handle-agent.ts` - `withastro-flue:packages/runtime/src/runtime/inspect.ts` - `withastro-flue:packages/runtime/src/tool.ts` - `withastro-flue:packages/runtime/test/workflow-runs.test.ts` - `withastro-flue:packages/sdk/src/index.ts` - `withastro-flue:packages/slack/src/index.ts` - `withastro-flue:pnpm-workspace.yaml` - `withastro-flue:README.md` - `withastro-flue:turbo.jsonc`