echo-agent

中文文档
0.5.0发布于 2026/11/03MITES Module构建来源已验证

Echo's general agent: the official CLI and interactive TUI. The same agent runs interactively and through a Unix pipe. Assembly lives in @echo-agent/base, the terminal shell in @echo-agent/tui. Requires Bun.

原始使用文档
文档目录3 节
  1. Run it
  2. What this package is
  3. License

echo-agent

Echo's general agent: the official CLI and interactive TUI. The same agent runs interactively and through a Unix pipe.

Requires Bun. The executable is TypeScript with a #!/usr/bin/env bun shebang, and the package exports resolve only under Bun. Node is not supported for this package. If you want the runtime as a library on Node, use @echo-agent/core instead — that one ships compiled JavaScript and is covered by a distribution test that installs the tarball into a clean project and runs it with Node.

Status: 0.x. Until 1.0, a minor version may contain breaking changes.

Run it

bun add -g echo-agent
MOONSHOT_API_KEY=sk-... echo-agent

Or run it once without installing: bunx echo-agent.

In a terminal this opens the interactive UI. With redirected stdin, each input line is one turn; model text goes to stdout and operational output goes to stderr.

printf 'Introduce yourself in one sentence.\n' |
  MOONSHOT_API_KEY=sk-... echo-agent

See every option with --help. Select a provider with --provider and override its default model with --model; the default provider is Kimi.

ProviderCredential environment variable
kimiMOONSHOT_API_KEY or ECHO_LLM_API_KEY
deepseekDEEPSEEK_API_KEY
openaiOPENAI_API_KEY or ECHO_LLM_API_KEY
zaiZAI_CODING_CN_API_KEY, ZHIPU_API_KEY, or ECHO_LLM_API_KEY
minimaxMINIMAX_API_KEY or ECHO_LLM_API_KEY

What this package is

This is the general agent: it knows no specific product and ships no file or shell tools. Its launcher parts come from @echo-agent/base and its terminal shell from @echo-agent/tui. @echo-agent/coding is a sibling product built from the same two packages, not on top of this one.

Full documentation, the runtime API and the two-product layout are in the repository README.

License

MIT. See LICENSE.

版本与发布记录

echo-agent 共发布 6 个版本,首次发布于 2026/08/31;过去 12 个月发布了 6 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.5.0latest2026/11/03今天
0.4.02026/11/03今天
0.3.02026/10/304 天前
0.2.02026/09/141 个月前
0.1.02026/09/101 个月前
0.0.02026/08/312 个月前

关于 echo-agent 的常见问题

echo-agent 是什么?

Echo总代理:官方CLI和交互式TUI。同一代理通过Unix管道以交互方式运行。程序集位于@echo-agent/base中,终端shell位于@echo-agent/tui中。需要面包。

如何安装 echo-agent?

在项目目录运行 npm install echo-agent,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 echo-agent,可以用 npx echo-agent 直接运行。

echo-agent 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/echo-agent 是否存在。

echo-agent 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

echo-agent 可以商用吗?

echo-agent 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

echo-agent 还在维护吗?

最新版本 0.5.0 发布于 2026/11/03(今天);至今共发布 6 个版本,其中过去 12 个月发布了 6 个;首次发布于 2026/08/31。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。