一个命令行工具, 帮你快速找到想要使用的命令.
Fast 🚀, cheap 🤩, and low-spec 🗿 -- driven perfectly by gpt-4o-mini or gpt-5.4-mini.
out.mp4
cargo install --git https://github.com/azazo1/howlto.git或者查看 Releases 中预编译的可执行文件.
默认配置目录: ~/.config/howlto/config.toml (Windows 下 ~ 为 %USERPROFILE%).
先启动一次 howlto 创建配置文件 (可以忽略此次报错),
修改配置文件中的 api_key 和 base_url (目前只支持 openai 格式, 需要 /v1 后缀),
然后就能正常使用了.
Note
项目仍然处于非常初步的阶段, 可能会引入许多 breaking changes💥, 因此可能在某次更新后需要手动调整配置内容以继续使用.
直接像普通的英语句子一样提问:
howlto upgrade all bun packagesHow to upgrade all bun packages?
你会获得一个选项框, 可以复制, 编辑, 执行模型提供的命令等.
如果你只想获取纯净的输出, 且无需交互:
howlto -pq list all files直接连接管道并执行:
howlto -pq list all files | head -n 1 | xargs $SHELL -cWarning
这个命令会直接执行模型输出的结果, 务必谨慎小心.
如果你想手动附加某些帮助信息作为辅助:
cargo --help | howlto cargo build with no default feature更多使用场景见: 示例.
以 fish 为例子, 执行下面的命令:
command howlto --init | source来进行 shell 集成, 你也可以把这行初始化命令添加到 ~/.config/fish/config.fish 这类文件中.
其他 shell 的集成命令参考: Shell 集成.
shell 集成之后, 可以使用以下 features:
-
Enter选择命令后自动填写到输入缓冲区. -
自动修复上一条命令
git psh -to origin main howl # git push -u origin main就像在提问: How?
见: Todo
只有 macOS Apple Silicon 被测试运行过, 其他平台上的使用如遇问题欢迎提出 issues.
| 平台 | 状态 | 说明 |
|---|---|---|
| macOS (Apple Silicon / Intel) | ✅ 主要测试平台 | 沙箱后端 Seatbelt (sandbox-exec). |
| Linux | ✅ 已支持 | 沙箱后端 Bubblewrap (bwrap), 需系统已安装 bwrap. |
| Windows (原生) | 只读沙箱后端 (macOS Seatbelt / Linux Bubblewrap) 仅在 Unix 可用, 在 Windows 下会触发 compile_error! 直接编译失败, 因此原生 Windows 暂时无法构建/运行. shell 集成也仅实现了 Unix 系 shell (fish/bash/zsh/nushell), 待沙箱后端与 Windows shell 集成落地后才能整体可用 (见 Todo). |
|
| Windows (WSL) | ✅ 推荐 | 在 WSL 内按 Linux 方式使用即可获得最佳体验, 配合 fish shell 效果最好. |
项目对 Unix 系 (macOS / Linux) 的支持最为完善, 强烈建议在 Unix 系配合 fish shell 使用.
- ⭐TheR1D/shell_gpt: howlto is inspired by this repo.
- 🦆szyazi/yazi: for it's shell integration method.
- 🧠ajeetdsouza/zoxide: for it's shell integration method.
- 🗯️nvbn/thefuck: for it's shell integration method and fixing commands ideas.
- 📒tldr-pages/tldr: for it's TL;DR content.