smelt
一个装在终端里的快速编码 Agent,单二进制安装,用可热重载的 Lua 改造成你想要的样子。
- Star 数
- ★ 73
- 最近更新
- 2 天前
- License
- MIT
- 主语言
- Rust
- FA 评分
- 50/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台ChatGPT · Claude Code · OpenAI API · Claude API
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 长期在终端里工作的后端或系统开发人员,希望用一个轻量二进制替代体积数百 MiB 的编码 Agent。
- 不适合
- 需要稳定 API、不愿跟随 beta 版本接口变动的团队
- 无法使用终端、只习惯图形界面的用户
- 必须在 Windows 上使用 x86_64 以外架构的用户
- 官网
- smeltagent.dev ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-18最新版本 v0.8.1(2026-11-18)
- 源码审查
- 50/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
smelt 是一个面向终端的编码 Agent,以单个小体积二进制分发,通过 shell 安装脚本或预编译包安装,也可用 cargo 从源码构建。它的核心特点是可改造性:快捷键、命令、工具和界面都由纯 Lua 文件定义,修改后实时生效,无需重启或重新编译。项目自带从零编写的终端渲染器,宣称在数万条消息的会话中打字和滚动依然即时,并在提示框与转录区提供 Vim 风格的移动、搜索与复制。它支持通过 smelt auth 登录 ChatGPT、GitHub Copilot、Kimi Code 等订阅型服务,也支持任意 OpenAI 兼容端点与本地 Ollama 模型;还能把本机安装的 Claude Code 作为 provider 运行,由 Claude Code 负责认证、Agent 循环与原生工具,smelt 提供终端界面、权限控制以及通过 MCP 暴露的额外工具。项目目前处于 1.0 之前的 beta 阶段,接口可能随版本变化。
smelt 在终端中启动一个交互式会话,读取你的提示后调用所配置的模型 provider 完成编码任务,并把模型输出、工具调用过程渲染在自有终端界面里。配置文件位于 ~/.config/smelt/init.lua,其中可启用内置插件(如 which_key、本地请求检查器、基于 LSP 的语义代码工具),也可改写快捷键、命令、工具与 UI,改动实时重载。模型接入有几条路径:smelt auth 完成 ChatGPT、GitHub Copilot、Kimi Code 的一次性登录;--model 配合 --api-base、--api-key-env 指向任意 OpenAI 兼容端点(如本地 Ollama);或把已登录的 Claude Code 作为 provider,此时 smelt 通过 MCP 向 Claude Code 提供额外工具与权限界面。默认模式循环为 Normal → Plan → Apply → Yolo,Plan 模式随包附带并自动加载。
- 长期在终端里工作的后端或系统开发人员,希望用一个轻量二进制替代体积数百 MiB 的编码 Agent。
- 习惯 Neovim 的开发者,希望在 Agent 输出里直接用 Vim 移动、搜索和复制,而不切换鼠标。
- 需要定制快捷键、命令和工具集的团队,想用 Lua 脚本按自己工作流改造 Agent 且改完立刻生效。
- 已有 GitHub Copilot 或 ChatGPT 订阅、不想再单独购买 API 额度的个人开发者。
- 想用本地 Ollama 模型跑编码任务、减少把代码发送到外部服务的用户。
- 已经用 Claude Code 登录并希望获得更顺手的终端界面和额外工具的开发者。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
curl -fsSL https://smeltagent.dev/install.sh | shcargo install --locked --git https://github.com/leonardcser/smelt.git smelt-agent
- 环境变量
OPENAI_API_KEY- 配置文件
~/.config/smelt/init.lua- 安装说明涉及
- Windows · macOS · Linux
如何安装或部署这个 Agent?
使用官方安装脚本:
curl -fsSL https://smeltagent.dev/install.sh | sh或从 Releases 页面下载预编译包,支持 Linux 与 macOS 的 x86_64 与 aarch64,以及 Windows 的 x86_64;解压后把 smelt(Windows 上为 smelt.exe)放进 PATH。
也可以从源码安装,需要 Rust 工具链:
cargo install --locked --git https://github.com/leonardcser/smelt.git smelt-agent如何使用这个 Agent?
订阅型服务先登录一次,之后直接运行即可,provider 会从凭据自动识别:
smelt auth
smelt使用本机已登录的 Claude Code:
claude auth login
smelt使用任意 OpenAI 兼容端点(示例为本地 Ollama):
smelt --model qwen3.6:27b --api-base http://localhost:11434/v1使用带 API key 的云端端点:
smelt --model gpt-5.5 --api-base https://api.openai.com/v1 --api-key-env OPENAI_API_KEY不带参数直接运行 smelt 会进入配置向导。插件在 ~/.config/smelt/init.lua 中启用。
这个 Agent 有哪些优点和局限?
- 单二进制分发,README 基准显示安装体积 47 MiB、启动 36 ms、64 轮后内存 102 MiB,明显低于对比的多数同类工具。
- Lua 插件可在运行中热重载,快捷键、命令、工具和 UI 都能改,无需重启或重新编译。
- 自研终端渲染器针对大量消息的长会话优化,并复用自写的渲染路径而非 ratatui。
- 提供 Vim 编辑体验,提示框和转录区共享同一套移动操作。
- provider 选择宽:ChatGPT、GitHub Copilot、Kimi Code 订阅,任意 OpenAI 兼容端点,以及本机 Claude Code。
- MIT 许可,代码可审计、可自行修改与再分发。
- 明确标注 1.0 之前为 beta,接口可能随版本变化,升级有破坏自定义脚本和插件的风险。
- 预编译包仅覆盖 Linux/macOS 的 x86_64 与 aarch64 及 Windows x86_64,其他平台需自行从源码构建并具备 Rust 工具链。
- 需要终端操作习惯;不熟 Vim 或命令行的人上手成本较高。
- 基准数据为项目方自测(3 次取中位数),未提供第三方复现结果。
- Claude Code provider 依赖本机已安装并登录的 Claude Code,且项目声明与 Anthropic 无关联,存在上游限制。
这个 Agent 与同类方案有什么区别?
README 在基准表中直接对比了 pi、fx、codex、omp、claude code 与 opencode 的安装体积、启动时间、内存与 CPU 占用,并声明受 Claude Code 与 Neovim 启发;其中 smelt 在 64 轮后内存上优于全部对比项,CPU 单项则略逊于 pi。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| smelt 当前 | 50 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 73 | 2 天前 | Rust | ChatGPT · Claude Code · OpenAI API · Claude API |
| Mini-Kode | 43 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 305 | 18 天前 | TypeScript | OpenAI API |
| rpi:Rust 编码代理运行时 | 71 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 287 | 今天 | Rust | OpenAI API · Claude API |
| Aster | 70 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 139 | 20 天前 | Rust | OpenAI API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
SECURITY.md 明确说明 Lua 配置、插件、技能、MCP 与受信任的 .smelt 配置以进程内同等 OS 权限运行、不做沙箱,权限模式只是减少误操作而非安全边界;这是诚实披露但意味着最小权限基本缺失。README 提到 Normal→Plan→Apply→Yolo 模式循环与 /trust 门控,说明存在确认机制,但样本中未见具体确认 UI 或默认拒绝策略,故仅给 1。数据流方面仅说明模型提供方会收到提示与上下文,缺少逐请求审计细节(虽提到 request inspector 与 export requests,但未在样本中展示)。敏感数据处理、依赖安全(Cargo.toml 有锁定版本但无审计/漏洞扫描证据)、外部副作用与回滚(有 session backup/doctor 但无工具级撤销)均只有间接线索,故各给 1。来源归属:README 致谢 Claude Code 与 Neovim 灵感,LICENSE 为 MIT,但未验证发布者身份,故 1。
Cargo.toml 使用 workspace 依赖并锁定版本,CI 有 nextest、clippy、fmt、覆盖率门槛与 MSRV 矩阵,说明依赖可用性与自洽性有工程支撑,给 2。失败信息方面样本中仅有 xtask 的 eprintln 用法与 fuzz 日志约定,未见面向用户的错误分类或恢复指引,故 1。
README 清晰描述目标用户(终端编码者)、场景(订阅/API-key/Claude Code 提供方)、安装与运行方式,技能文件(brief/handoff/customize/fuzz-triage)展示了明确触发条件与边界(如 customize 明确不用于普通编码),给 2。能力边界在 SECURITY.md 与 README 中有说明,但缺少对不支持场景的系统列举,故未给 3。
README 结构清晰、安装说明完整(curl 脚本、预编译二进制、cargo install),LICENSE 为完整 MIT 文本给 3。但 README 明确 beta 且接口可能变化,版本号 0.0.0-dev,changelog 仅在 AGENTS.md 提及发布时生成,未见实际 CHANGELOG 文件,故命名稳定性与版本化各给 1。示例与 FAQ 仅有 demo GIF 与文档外链,样本内无 FAQ,给 1。已知限制在 SECURITY.md 与 README 警告中有体现,给 2。维护责任因发布者未验证、仅单一维护者署名,给 1。
产品定位明确(轻量、Lua 可脚本化、自带终端渲染器),技能文件输出格式具体(brief/handoff 有固定结构),对目标用户有实用价值,给 2。但基准数据为自报、方法外链、无独立复现,成本收益仅能部分采信,故 cost_benefit 给 1。
README 基准表标注日期与中位数但方法在外部链接,样本内无法追溯;技能与代码可交叉印证部分声明(如 customize 提到的路径与 runtime/skills 结构一致),但整体声明多为自述,事实与推断分离有限,三项各给 1。
- Lua 插件与受信任的 .smelt 配置以进程内同等 OS 权限运行且不沙箱化,加载第三方配置前必须人工审查。
- 权限模式(含 Yolo)不是安全边界,不能依赖它防御恶意插件或配置。
- README 基准数据为自报且方法外链,样本内无法独立验证,不应作为选型唯一依据。
- 项目处于 beta,接口可能变化,版本号为 0.0.0-dev,升级前需评估兼容性风险。
- 发布者身份未经 FollowAgents 验证,维护责任与更新路径需自行核实。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
Upgrade notes - smelt no longer uses the OS keyring for OAuth credentials, so startup no longer prompts for macOS Keychain access. If your credentials were stored only in the keyring, sign in again with smelt auth. Added - Preview image attachments and move them within the prompt before sending. - Stash a Vim visual selection without stashing the rest of the prompt. - Redeem available Claude Code quota reset credits from /usage. - See messages between Claude Code agents in the transcript. - The startup banner shows upgrade status next to the version. Changed …在 GitHub 查看 ↗ -
发布说明摘录
Published [smelt-term v0.9.0](https://crates.io/crates/smelt-term/0.9.0) to crates.io. ```toml smelt-term = "0.9.0" ```在 GitHub 查看 ↗ -
发布说明摘录
Breaking - Sessions live in one SQLite database. The first start imports smelt 0.7 data. - Goals and notebook editing are opt-in. Add require("smelt.plugins.goal") or require("smelt.plugins.notebook") to ~/.config/smelt/init.lua. - donut is opt-in. barrelroll loads by default. - The status file schema is 2. It drops expires_at_ms, boot_id and process_start_time_ticks. A held <pid>.lock proves a session is alive. Added - /files and /files git search workspace or Git-tracked files and preview the source. …在 GitHub 查看 ↗
常见问题
smelt 本身收费吗?
Claude Code 模式会把我的订阅凭据复制走吗?
自定义 Lua 改动会立即生效吗?
能在哪些系统上运行?
有权限控制吗?
smelt 官网是什么?
smelt 开源吗?
smelt 还在维护吗?
smelt 是谁开发的?
谢谢反馈,我们会据此改进页面。