vomit README

The project's README from github.com/zachahn/vomit. As one markdown file: README.md.

Vomit

Vomit converts Claude's token vomit into English by piping it through a local LLM. It's fully local (no telemetry) and has no external dependencies.

Vomit hooks into Claude Code, rewriting all its output within the Claude Code terminal UI.

Disclaimer:

Install

# Install the binary to your GOPATH
go install github.com/zachahn/vomit@latest

# Setup connection details to your LLM
vomit init

# Instructions on how to replace Claude's output via hooks
vomit scrub -claude

Usage

In addition, there's a non-invasive mode if you want to run Vomit on the side. (This is deprecated.)

This should work with:

If you don't have a local LLM set up already, I think I recommend using Llama.app, and downloading GPT-OSS 20B through it. Run the init subcommand after you set this up.

Tips

License

GNU GPLv3

vomit (zachahn/vomit)

Searching Database…

200 ·GitHub
这是什么?Vomit 通过本地 LLM 把 Claude Code 吐出的大量 token 转换成通顺的英文。它挂接到 Claude Code,直接在 Claude Code 的终端界面里改写其输出。
这是独立应用,还是挂接到 Claude Code 的终端?它是用 Go 编写的 CLI 工具,挂接到 Claude Code,在现有的 Claude Code 终端界面内拦截并改写其输出,而不是另开一个界面。
怎么让它和 Claude Code 一起跑起来?安装 Vomit,然后用“vomit list”查看 Claude 会话标识,用“vomit tail”翻译或跟踪会话输出。还有一种非侵入模式可以在旁边运行 Vomit,不过该模式已被弃用。
运行它需要什么样的本地 LLM?你需要一个本地 LLM 后端,比如 Llama.app、Ollama、Apfel(macOS 26+)或任何提供 OpenAI 兼容 API 的东西。README 推荐 Llama.app 搭配 GPT-OSS 20B 模型,配置好后再运行一次 init 子命令。
翻译后的输出总是通顺合理吗?本地 LLM 只能看到 Claude 想传达的内容,无法访问 Claude 的实际操作或文件,因此可能会胡编。该项目还被描述为“完全凭感觉写的(totally vibe-coded)”,只在 Mac 上测试过,而且相当慢。
它只能在 Mac 上用吗?它只在 macOS 上测试过,而且推荐的本地 LLM 运行器之一(Apfel)明确要求 macOS 26 或更高版本。
我的 Claude 会话数据会去哪里?Vomit 完全在本地运行,没有遥测,也没有外部依赖,会话输出留在你的机器上,只会发送给你配置的本地 LLM。
怎么查看 Claude 未修改的原始输出?在 Claude Code 内按 ctrl-o 即可查看 Claude 原始、未翻译的输出。
非侵入模式是什么?它让你在旁边运行 Vomit,而不是直接挂接到 Claude Code 的终端,但 README 已把该模式标记为弃用。
“vomit tail”到底是做什么的?它翻译指定会话的 Claude token;如果未指定会话,则跟随最新的活动会话。
作者为什么把它叫做“vomit”?这个名字玩的是这样一个梗:用本地 LLM 把 Claude 冗长、术语满天飞的(“呕吐物”式)输出清理成通顺的英文。
Creator
zachahn
Size
0.1 MB
Stars
200
Updated
CommitSep 09
Age
2mo
Commits · 90 Days