whycorporation/whycodes

English · 简体中文 · Русский · Español

面向终端的快速、与供应商无关的编程智能体，使用 Rust 编写。

WhyCodes 可读写并编辑文件、运行命令、搜索工作区，并通过多轮工具调用驱动 大语言模型 —— 既有全屏 TUI，也可作为机器可读的一次性 CLI。它强调较小的 原生体积、空闲时高效的 TUI，以及不绑定任何单一模型供应商的工作流。

为什么选择 WhyCodes

• 即刻启动。 在 Linux 上 whycodes --version 1.4 ms 即返回。
• 空闲时零开销。 TUI 仅在有变化时绘制：空闲会话每秒绘制 0 帧。
• 体积小巧。 十个空闲会话共占 41.9 MB，每多一个约 3.1 MB；恢复一个 3000 条消息的会话占用 34.7 MB。
• 使用你选择的模型。 托管 API、本地模型服务器或任何 OpenAI 兼容端点 —— 可按每次运行或在会话中途切换。

在同一台机器上测得；方法与注意事项见性能。

亮点

• 单一原生二进制。 无需安装其他任何东西：搜索在进程内完成；在 Windows 上命令无需 WSL 即可运行（若已安装 Git for Windows 则通过它运行，否则使用 内嵌的 bash 兼容 shell）。
• 跨平台。 Linux、macOS 与 Windows 使用同一套工作流。
• 任意供应商。 Anthropic、OpenAI、Google、GitHub Copilot、Groq、xAI、 DeepSeek、Ollama、OpenRouter、Mistral、Together，LM Studio、vLLM、 llama.cpp 等本地服务器，或任何 OpenAI 兼容端点。
• 贴合你的项目。 从 AGENTS.md 加载项目说明，并通过 LSP 连接已有的 MCP 工具与语言服务器。
• 记住你的工作。 可分支与恢复的持久化会话、跨会话记忆（MEMORY.md、 语义召回）以及可选的代码索引。

安装

安装脚本（Linux、macOS）

curl -fsSL https://why.codes/install | bash

安装脚本（Windows）

irm https://why.codes/install.ps1 | iex

会将 %LOCALAPPDATA%\Programs\whycodes 加入用户 PATH。不需要 WSL。

Homebrew（macOS；Linuxbrew x86_64）

brew tap whycorporation/whycodes https://github.com/whycorporation/whycodes
brew install whycorporation/whycodes/whycodes

brew trust --formula whycorporation/whycodes/whycodes
brew install whycodes

Cargo（crates.io）

cargo install whycodes-cli --locked

从源码构建 whycodes 二进制（需要 Rust 1.91+）并安装到 ~/.cargo/bin。 Linux 和 macOS 链接系统的 libsqlite3（pkg-config）；加上 --features bundled-sqlite 可改为内置 SQLite。再次运行同一命令即可更新。

从源码构建

# 需要 libsqlite3（pkg-config）。完全静态二进制：
# cargo build --release -p whycodes-cli --features bundled-sqlite
cargo build --release -p whycodes-cli

使用 whycodes upgrade 更新（脚本 / cargo 安装），或 brew upgrade whycodes（Homebrew）。交互式 TUI 会话会检查 GitHub 上的新版本，并在主 屏幕安装前提示；传入 --no-auto-update 可跳过检查。安装脚本会对照已发布 的 SHA256SUMS 校验发行产物。可下载二进制与卸载说明见 docs/packaging.md。Windows 发行二进制的签名方式见 Code signing policy。

配置和会话位于 ~/.whycodes（Windows 上为 %USERPROFILE%\.whycodes）， 若设置了 $WHYCODES_HOME 则位于该目录。

eval "$(whycodes completions zsh)"    # ~/.zshrc
eval "$(whycodes completions bash)"   # ~/.bashrc
whycodes completions fish > ~/.config/fish/completions/whycodes.fish

快速开始

export ANTHROPIC_API_KEY="sk-ant-..."

whycodes -d ./my-project                            # 交互式 TUI
whycodes generate "Explain main.rs" -d ./my-project # 一次性命令
whycodes generate "Summarize the last commit" --format json
whycodes --continue                                 # 恢复上次会话
whycodes -P openai -m gpt-5 generate "Refactor this module"

没有 API 密钥？在本地运行模型：

whycodes -P ollama -m qwen2.5-coder               # Ollama
whycodes provider discover --save                 # 查找 LM Studio、vLLM、llama.cpp

订阅 OAuth 登录（whycodes auth login <provider>）仅在安装本地 kind: "auth" 插件后可用 —— WhyCodes 不附带第三方 OAuth 客户端。见 docs/auth.md。

完整指南 —— CLI 参考、TUI 快捷键、斜杠命令、智能体、工具与配置 —— 见 docs/guide.md。

功能

性能

2026-10-16 在同一台机器（Ryzen 7 3800X）上测量：Windows 11 原生运行， Linux 运行于 WSL2。方法、历史数据与注意事项见 docs/benchmarks.md：

TUI 仅在有变化时绘制，空闲会话不会重绘。恢复一个 3000 条消息的会话占用 34.7 MB，十月的内存优化之前为 216 MB。首帧 harness 只计时一次启动画面绘制， 而非完整主屏幕。

工作区行覆盖率低于 98.5% 时 CI 失败，二十四个 crate 的生产代码行覆盖率保持 100% —— 见 docs/coverage.md。

文档

贡献

欢迎贡献。CONTRIBUTING.md 是从克隆到合并变更的短路径； AGENTS.md 约束在本仓库中工作的编程智能体。参与即表示同意 行为准则。帮助与缺陷报告：SUPPORT.md。 请通过 SECURITY.md 报告漏洞，不要开公开 issue。

社区

网站：why.codes。

赞助

WhyCodes 独立开发，需要资金才能持续发布。请通过 GitHub Sponsors 赞助本项目。

Star 历史

许可证

MIT