一个终端编码代理，用Rust编写。一个静态二进制文件，任何模型提供程序，没有您的允许，什么都不应用。
实二进制；只有模型是脚本化的，因此可以为每个发布版本再次记录演示(scripts/demo/record.sh）。
Hoocode读取你的代码，运行命令，编辑文件，并与你的模型 选择，从全屏终端UI或作为一个一次性命令。它是一个单一的本地 binary：不需要Node，不需要Python，不需要安装运行时。
- 任何供应商。 Anthropic, OpenAI， b谷歌，OpenRouter, Groq, DeepSeek, xAI, Fireworks
以及更多，通过API键或
/login（Anthropic, GitHub Copilot, OpenAI Codex， b谷歌）。 - 你要控制自己。 Shell， Edit and Write先问（Yes / No / Always）。四个 代理模式（询问、计划、构建、调试）限定代理可以做什么。
- 子代理。 代理可以将工作手工传递给后台的子代理并继续运行；他们的 工具调用要经过与主代理相同的审批门。
- 你可以回来参加会议。
--continue，/resume，/fork，/tree, 自动压缩长对话。 - 可扩展的开放格式。
AGENTS.md/CLAUDE.md背景文件、技能、 提示模板和斜杠命令，MCP服务器，插件，主题和键绑定。 - 脚本。 打印模式(
-p)输出文本或JSON，以及JSON- rpc模式 （--mode rpc)用于从另一个程序中驱动hoocode。
安装
Hoocode运行于 macOS和Linux，支持x64和arm64． Linux构建是静态的 （肌肉），所以一个二进制文件可以在任何发行版上运行。目前还没有Windows版本。
安装脚本 （无root，无Node）：
curl -fsSL https://kolisachint.github.io/hoocode/install.sh | sh
它为您的平台下载发布归档，并根据发布进行检查
SHA256SUMS、安装 ~/.hoocode/bin/hoocode (加上一个 hoo 别名)和添加
~/.hoocode/bin 到你的 PATH。通过 --help 对于选项(--version， --dir，
--no-modify-path）. 脚本如下 install/install.sh 在这个回购。
NPM或bun （Node 18或更新版本）：
npm install -g hoocode # or: bun add -g hoocode
该包仅为您的平台导入本机二进制文件。它安装 hoocode
和 hoo.
皮普 （Python 3.8或更新版本）：
pip install hoocode # or: pipx install hoocode
一个瘦启动器：在第一次运行时，它会下载你的平台的发布二进制文件，
检查它的sha256 SHA256SUMS 把它藏在下面 ~/.cache/hoocode/.
预先构建的二进制文件。 每一个 GitHub释放
有 hoocode-<target>.tar.gz 用于 x86_64-unknown-linux-musl，
aarch64-unknown-linux-musl， x86_64-apple-darwin 和 aarch64-apple-darwin，和
SHA256SUMS 文件。打开包装，放好 hoocode 在你的 PATH：
tar xzf hoocode-aarch64-apple-darwin.tar.gz
install -m 755 hoocode-aarch64-apple-darwin/hoocode ~/.local/bin/hoocode
从源 (Rust 1.88或更新版本；仓库将其开发工具链固定在
rust-toolchain.toml（生锈会自己捡起来）：
git clone https://github.com/kolisachint/hoocode
cd hoocode
cargo install --locked --path crates/hoocode-code-main --bin hoocode
或运行 scripts/install.sh，它构建一个发布二进制文件并将其安装为
hoocode 和 hoo． 默认情况下，它会更新 $HOOCODE_INSTALL_DIR/bin 当
目录已包含可执行文件 hoocode;如果 HOOCODE_INSTALL_DIR 是
取消设置，它检查 ~/.hoocode/bin 代替。否则，它将安装到
~/.local/bin。通过 --prefix DIR 覆盖目标。
Hoocode不在板条箱上。io或Homebrew。
更新。 hoocode update 打印安装方式的正确更新命令。
快速启动
export ANTHROPIC_API_KEY=... # or any provider key, see `hoocode --help`
cd your-project
hoocode # full-screen interactive session
没有API密钥？开始 hoocode 和运行 /login 以订阅方式登录。
在互动环节中可以尝试以下内容：
| 类型 | 它是做什么的 |
|---|---|
/model | 选择一个模型（Ctrl+P在你最喜欢的模型中循环） |
/mode | 在询问、计划、构建和调试之间切换 |
/resume | 在此文件夹中重新打开较早的会话 |
@path/to/file | 在邮件中附加一个文件 |
/hotkeys | 显示键盘快捷键 |
/settings | 改变设置 |
一次性和脚本使用：
hoocode -p "Summarize this repo" # print the answer and exit
hoocode -p --mode json "List the TODOs in src/" # JSON event stream
hoocode --model anthropic/claude-sonnet-4-5 "Review the last commit"
hoocode --continue "And now fix the first one" # continue the last session
hoocode --tools Read,CodeSearch -p "Review src/" # read-only run
hoocode --mode rpc # JSON-RPC over stdin/stdout
插件添加技能，子代理和MCP服务器。添加一个git市场，然后安装
从它，从壳或与 /plugin 在会话中：
hoocode plugin marketplace add <git-url-or-owner/repo>
hoocode install <plugin>@<marketplace> # --scope project for this repo only
hoocode list
hoocode --help 列出每个标志和提供程序环境变量；
hoocode --list-models [search] 列出它知道的模型。
配置
所有hoocode保存的东西都存在 ~/.hoocode． 集 HOOCODE_CODING_AGENT_DIR 来
移动它。
| 文件或文件夹 | 它包含什么 |
|---|---|
~/.hoocode/settings.json | 全局设置(/settings 编辑) |
.hoocode/settings.json | 每个项目设置，在全局设置上合并 |
~/.hoocode/auth.json | 登录名和密钥由保存 /login |
~/.hoocode/models.json | 您自己的提供程序和模型（例如本地openai兼容服务器） |
~/.hoocode/hoo-config.json | 代理模式和工具审批规则 (auto_allow） |
~/.hoocode/skills/， .hoocode/skills/ | 技能，全球和每个项目 |
~/.hoocode/themes/ | 自定义主题 |
~/.hoocode/sessions/ | 保存的会话，每个JSONL文件，在每个项目的文件夹中(HOOCODE_CODING_AGENT_SESSION_DIR 或者 --session-dir 移动它们) |
~/.agents/mcp.json， .agents/mcp.json | 全局和每个项目的MCP服务器(/mcp 显示它们的状态) |
~/.agents/plugins/， .agents/plugins/ | 插件、用户和每个项目 (hoocode install， hoocode list，或者 /plugin 在一个会话中) |
AGENTS.md 或者 CLAUDE.md | 项目说明，从工作文件夹及其父文件夹中读取 |
因为会话被保存为文件，所以您可以恢复、分叉或导出
他们 (/export <file>.jsonl）。 --no-session 保持短暂的运行，并且 --offline
关闭启动网络调用，如版本检查。
文档
docs/user/: 用户文档，发布于 https://kolisachint.github.io/hoocode 每次发布docs/maps/ui.md：屏幕，选择器，斜杠命令和键， 以及它们在代码中的位置docs/maps/packages.md: 工作区中的每个板条箱和 它是做什么的docs/design/：设计说明和路线图docs/design/distribution.md: 发布如何到达用户CHANGELOG.md什么改变了/changelog内部hoocode)
贡献
试一试，然后告诉我们
您可以做的最有用的事情是尝试hoocode并告诉我们它是如何进行的。
- Bug还是想法？ 打开一个问题.
- 问题？ 询问 讨论.
- 想要发送PR？ 拉请求是受欢迎的。从……开始 你的第一个pull请求 和 好的第一个问题.
CONTRIBUTING.md 涵盖开发循环 (fmt，clippy，nextest)， 测试的去向以及发布的工作方式。请阅读 行为准则，并将安全问题私下报告为 描述在 SECURITY.md.
如果hoocode对你有用，回购上的星星可以帮助其他人找到它。
学分
hoocode开始作为一个叉 pi-mono 由
Mario Zechner，麻省理工学院授权。其版权声明保存在 许可证.
感谢Mario和上游贡献者。
许可证
麻省理工学院,看到 许可证.