Flue CLI完全指南在终端玩转你的AI Agent【免费下载链接】flueThe sandbox agent framework.项目地址: https://gitcode.com/GitHub_Trending/flue1/flueFlue CLIflue命令行工具是 Flue 这个沙箱 AI Agent 框架的终端入口它让你不用打开浏览器就能在本地一键初始化 Agent 项目、直接运行 AI Agent 并与它对话、拉取现成的集成蓝图Blueprint甚至离线搜索全部官方文档。本指南面向新手带你用 5 个常用命令从零跑通一个属于自己的 AI Agent 为什么选择 Flue CLI 来运行 AI Agent很多 Agent 框架要求你起一个 Web 服务再打开页面调试而 Flue 的思路完全不同Agent 就是一个普通的 TypeScript 函数CLI 负责把模型、沙箱、工具、技能等运行环境一次性装配好然后直接把回复打印到终端。Flue 框架的核心能力包括Agents——跨对话保持上下文的自主 AgentSandboxes——安全的沙箱环境让 Agent 能跑代码、改文件Tools / Skills——类型安全的工具调用与可复用技能包Channels——Slack、Teams、Discord、GitHub 等消息通道接入CLI 源码位于 packages/cli/核心命令注册逻辑见 cli.ts它一共注册了四个命令家族run、init、add/update、docs。如何安装 Flue CLI3 步完成配置前提条件Node.js ≥ 22.19.0见 package.json 中的engines配置。第 1 步安装 CLI在你的 Agent 项目目录中执行npm install -D flue/cli第 2 步验证版本npx flue --version第 3 步准备模型 API Key把你的模型提供商密钥如 Anthropic、OpenAI写入项目根目录的.env文件flue run会自动加载。 想从源码了解 CLI 的构建方式可以查看 packages/cli/README.md 与官方示例 examples/hello-world/。如何用 flue init 初始化 AI Agent 项目flue init会用交互式提问帮你搭好一个完整项目骨架核心逻辑在 init.ts 中npx flue init ./my-agent-app运行后会依次询问两个问题问题选项含义What are you setting up?Run locally只在终端用flue run跑 AgentDeploy生成 HTTP 服务器配置可部署Both本地 部署全套Where will you deploy?CloudflareWorkers Durable ObjectsNode.js标准 Node 服务任意主机部署也可以跳过交互用参数直接指定npx flue init --target node --deploy完成后 CLI 会打印next steps清单告诉你下一步该写什么文件。目录非空或已存在flue.config.*时需要加--force才会覆盖。flue run一键本地运行你的 AI Agent 并对话这是最常用的命令实现见 run.ts。它执行无网络传输的一次性本地运行启动 Agent、打印回复、然后退出。npx flue run src/agents/hello.ts -m 你好介绍一下你自己执行后终端会显示品牌化的会话信息Agent 身份、会话 ID、数据库位置接着以user/assistant标签逐行打印对话内容最后输出agent completed✅。常用参数速查参数用途-m, --message text发送给 Agent 的用户消息必填--id id指定会话 ID可继续已有对话--name agent一个模块定义多个 Agent 时选择其中一个--data json创建会话时传入初始数据--env path加载额外的.env格式文件--json以 JSON 格式输出结果方便脚本处理多轮对话技巧--id让会话可以延续npx flue run src/agents/hello.ts -m 帮我总结昨天的会议纪要 --id support-4821 npx flue run src/agents/hello.ts -m 再展开第三点 --id support-4821⚠️ 按 Ctrl-C 中断时CLI 会优雅地排空正在执行的 Agent最多等待 5 秒而不是直接掐断避免半成品写入。如何用 flue add 拉取集成蓝图Blueprint当你想让 Agent 接入 Slack、Telegram、Postgres、Daytona 沙箱等平台时Flue 提供了蓝图——一份给 AI 编码代理执行的实现指南实现见 blueprints.ts仓库内置的蓝图模板在 blueprints/。查看可用蓝图清单npx flue add输出是一张三列表格命令、类别、对应网站覆盖sandbox、database、channel、tooling四大类例如flue add channel slack、flue add database postgres。把蓝图喂给你的编码代理npx flue add sandbox daytona --print | claude还支持从零构建模式——传入任意提供商文档的 URL作为蓝图的起点让 Agent 现场实现。升级已有集成则使用npx flue update kind name。flue docs离线搜索与阅读官方文档CLI 内置了完整文档实现见 docs.ts基于 MiniSearch 做全文检索断网也能查# 列出所有文档页 npx flue docs # 阅读某一页 npx flue docs read guide/sandboxes # 全文搜索返回 JSON 结果 npx flue docs search durable execution搜索对标题、小标题、描述做了加权支持前缀匹配与模糊匹配最多返回 8 条带摘要的结果。新手常见问题FAQQ1flue命令提示找不到确认已安装依赖且用npx flue调用或检查 Node 版本是否 ≥ 22.19.0。Q2和vite dev什么关系flue只负责本地一次性运行与脚手架开发服务器和生产构建由 Vite 的flue()插件接管来自flue/vite详见 packages/vite/。Q3模型在哪里配置在 Agent 函数里用useModel(provider-id/model-id)设置或在调用prompt/skill/task时按次传入{ model: ... }。Q4会话数据存在哪里flue run会把对话持久化到本地数据库终端会打印db路径所以同一个--id能跨命令续聊。总结Flue CLI 用四个命令覆盖了 AI Agent 开发的完整闭环init建项目 →run本地对话调试 →add拉取集成蓝图 →docs离线查文档。对于新手来说这是目前最轻量的方式把自主 AI Agent 真正跑起来——没有浏览器、没有复杂服务一切都在终端完成。现在就打开终端执行第一条npx flue init试试吧【免费下载链接】flueThe sandbox agent framework.项目地址: https://gitcode.com/GitHub_Trending/flue1/flue创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考