@erykkozyra/terminalhinter

中文文档
1.2.2发布于 2026/11/13MIT零依赖构建来源已验证近 30 天下载 1980

Zsh, bash, fish and PowerShell 的开源终端自动完成 : 文件夹、 git 分支、 npm 脚本和 700+ CLI 等的下拉

中文使用文档
文档目录20 节
  1. 安装
  2. 你为什么会喜欢
  3. 目录
  4. 它运行的地方
  5. 做的一切都一样
  6. 当出事时
  7. 你的项目
  8. 绕来绕去
  9. 清单本身
  10. 密钥
  11. 图标
  12. 来自基罗CLI或Fig
  13. 你自己的建议
  14. 片断
  15. 窗口
  16. VS 代码
  17. 更新和注销
  18. 解决问题
  19. 保存着的东西
  20. 贷项

终端时钟

npm license

类型 三字母。 得到整个指挥部. Zsh、bash、fish和PowerShell 的开源自动完成 macOS, Linux 和 Windows (英语). 它完成700+命令行工具 当你键入命令失败时, 将修正交给你, 并标出危险的红色.

terminalhinter completing a branch, fixing a typo and marking --force red

观看每个功能播放,并在浏览器中尝试没有安装 需要帮助.

安装

npm i -g @erykkozyra/terminalhinter
thint init

然后打开一个新的终端标签和类型 git 或者说 cd。 。 。 . thint init 找到你的贝壳 把它们全部装起来 每个配置的备份.

你为什么会喜欢

  • 一个失败的命令又被修复了. 在打字或缺失上游后,空行会提供固定和 Tab 拿着.
  • 红色之前你强迫-推. 删除或覆盖的条目为红色并说原因. Ctrl+G 解释每个词 连线.
  • 它读到你的项目. 您的脚本, Makefile 目标,分支 与他们的最后一次承诺的年龄 在您的端口上进行处理.
  • 输入文件夹 . 少数压力将你带入一个项目深处,名单会一直打开.
  • 没有允许,没有注册. 没有访问权限, 菜单栏里没有应用程序, 没有账户, 没有 遥测.

是来自Fig还是Kiro CLI, 它的自动完成在3.0? thint migrate 让你在一个命令中移动.

目录

它运行的地方

系统贝壳
macOS, Linuxzsh,出击,出击,出击,出击 PowerShell 7
窗口PowerShell 7, Windows PowerShell 5.1, Git Bash; cmd 由手动开始(thint -s cmd(中文(简体) )

任何终端应用作品:iTerm2,终端.app,Ghostty,WezTerm,Kitty,Alacritty,VS代码,Cursor,Windows终端, 和Tmux或屏幕在他们内部。 zsh和bash on macOS 和 Linux 的时间最长;鱼和Windows是 新来的,所以如果有东西看那边, 打开一个问题。 。 。 . nushell和xonsh来自上游项目,没有经过测试.

做的一切都一样

当出事时

  • 它为刚刚失败的指令提供了修正. 类型( E)gti → git),缺少上游分支,a 分支或脚本,带有近名,需要文件夹 -p,一个被带走的港口。 Tab 把它放在线上; 没有什么是自己运行.
  • Ctrl+G 在运行前解释一行每一个字,用它的意思, 通过管道, &&,方向调整和 sudo,对删除或覆盖事物的部分发出警告.
  • 危险条目标记为红色 并说为什么: --force, (中文(简体) ), reset --hard, (中文(简体) ), rm -r目标标记 [prod], (中文(简体) ), 调用 ssh 主机 PROD。 。 。 .

你的项目

  • 您的任务 : 使用其 ## 描述和章节, 仅是配方, 任务文件, 插件 编写服务、 mise 和 deno 任务、 package.json 脚本、 turbo 任务、 工作空间包 --filter。 。 。 .
  • 带有上下文 : 每支树枝旁边的末行的年龄和消息, 后反转 git reset,你的别名会像他们后面的命令一样完整.
  • 端口 : kill 起始于在端口上监听的进程,并带有其文件夹(:3000 next dev · ~/Dev/shop) (中文(简体) ).
  • 软件包版本 : npm i react@ 列出标签和最新发布(pnpm、纱线和包子也).
  • 云居语: 每个 aws 以命令和选项服务,以及 gcloud 组合和命令。 您的 S3 密码 桶,IAM角色和简介来自你拥有的aws CLI,有你自己的登录.
  • ku: 上下文,命名空间 -n,以及舱名,部署和其余的 组合,用于组合 --context 财务报告和审定财务报表 -n 在线上。 之后 kubectl config use-context 下一个列表是新的 组合的.
  • 你跑到这里的是: 输入第一个单词会带回您在这个文件夹中运行的全部命令, 以及那些命令 你跑到其他地方 在同一个仓库。 看起来像持有密码或信使的行从不存储.

绕来绕去

  • 输入文件夹 . 清单与内在内容保持开放 ↪ 条目运行命令 对. cd 也可以通过您的书签和正氧化物从任何地方找到文件夹.
  • 在你承诺之前先看一个文件夹. 它将文件夹放入线上并列出里面的内容; QQ 继续往上 行走后直接输入突出显示的文件夹 .

清单本身

  • 它能学会你用什么,和 Shift+上/ Shift+ 组合键 把名单按顺序排列.
  • 字母顺序足够了. chkt 发现 checkout。 。 。 .
  • 在空格之后, 空格没有选择,因此 Enter 只运行命令。 一个字你打满了,没有 条目从输入的运行开始.
  • 输入可以一次运行 : thint config set enterRuns true 让 Enter 接受条目并运行行.

The list after typing pnpm d

密钥

密钥它会做什么
输入接受、走入文件夹或运行命令 ↪
→在行尾突出显示的文件夹上: 查看里面, 回上去
标签接受所选条目
↑移动选中区域; 没有选择的%%%\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
移动QQQQ移动列表中选定的条目
英格兰隐藏列表直到再次输入
缩写+ 空间再来一次
Ctrl+G 数据每一句话都做什么
在空行上设置标签在命令失败后, 接受指定的修复

在Mac上,Ctrl是控制键 (QQ),而不是命令.

图标

命令它会做什么
thint init引导设置
thint theme选择一个主题: 薄、 浅、 淡、 淡或地拉
thint config显示或更改设置( E)所有人,他们(中文(简体) )
thint bookmark add书签文件夹,所以 cd 随时随地提供
thint specs new启动您对命令的建议
thint order reset忘了你和Shift QQ 设定的命令
thint snippets new启动您的片段: 有字段要填写的命令
thint migrate从Kiro CLI、Amazon Q 或 Fig 移动过来
thint update安装最新版本
thint doctor检查安装,告诉你如何修复
thint debug keys记录您的终端发送的密钥稀释用途

来自基罗CLI或Fig

Kiro CLI 3.0 放弃了自动完成,而Fig也不见了. 终端发报器在本地和 没有账户. thint migrate 从您 shell 文件中取出 KIRO CLI、 Amazon Q 或 Fig 线条( 保留 ) 每个文件的复制件),以及您自己在 ~/.fig/autocomplete/build 可以装入原样.

你自己的建议

对于内部脚本和工具,请输入一个 YAML 文件 ~/.config/terminalhinter/specs数字 :

name: deploy
subcommands:
  - name: staging
    args: { name: app, suggestions: [web, admin] }
  - name: logs
    args: { name: service, script: "ls services" } # every line of the output is a suggestion
options:
  - name: [--force, -f]
    description: Skip the checks

thint specs check 指出错误。 一个被损坏的文件被跳过,其余的继续工作.

片断

您经常输入的有要填入的字段的图标 ~/.config/terminalhinter/snippets.yaml (单位:千美元)thint snippets new 启动文件 :

- name: release
  command: "git tag v{{version}} && git push --tags"

键入名称,填入字段,完成的指令上线地.

窗口

运行 npm i -g @erykkozyra/terminalhinter 财务报告和审定财务报表 thint init 在"PowerShell 7"或"Windows PowerShell"中. 设置 并输入 ~/.bashrc 为了吉特·巴什.

Windows PowerShell 5.1会随着脚本的关闭而来,因此它会跳过它的剖面,列表从不从那里开始. thint init 仅允许您的用户使用脚本 (单位:千美元)Set-ExecutionPolicy -Scope CurrentUser RemoteSigned从一开始 PowerShell 7就有什么 若为 thint 或者说 npm 本身不会在 Windows PowerShell 中以同样的理由开始,使用 thint.cmd init 财务报告和审定财务报表 npm.cmd。 。 。 .

cmd 没有启动文件可以将行放入其中, 因此您用 thint -s cmd。 。 。 .

VS 代码

列表在这些设置中看起来最好:

"terminal.integrated.lineHeight": 1.3,
"terminal.integrated.minimumContrastRatio": 1,
"terminal.integrated.gpuAcceleration": "on"

minimumContrastRatio: 1 停止更改列表的颜色。 任意一空间字体有效 .

更新和注销

更新. thint update。一个新的标签会告诉你,当新版本出来时; thint config set updateCheck false 关掉它。 更新方式 npm i -g @erykkozyra/terminalhinter@latest 工作也一样:下个新标签会把它捡起来.

没有. 您标签中的列表从不取决于您的节点版本, 因为瘦子带有自己的运行时间 。 只有 thint 命令您输入的是全局 npm 软件包: 在您切换默认节点后, 运行 npm i -g @erykkozyra/terminalhinter 再说一遍,这个版本也有命令.

从源 (需要"节点"18+和"出""出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出""出"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

git clone https://github.com/ErykKozyra/terminalhinter.git
cd terminalhinter
./scripts/install-from-source.sh

单个二进制 ~/.local/bin/thint 这根本不取决于节点.

完全没有.

thint uninstall
npm rm -g @erykkozyra/terminalhinter

thint uninstall 从每个 shell 配置中取出启动行并删除瘦文件. thint init --remove 只取出启动行.

解决问题

开始 thint doctor它检查安装、每个外壳的起动线以及您的配置,并说如何 修复它找到的东西.

新标签没有列表 . 启动线不见了 或者有东西阻止了它们 运行 thint init ;它取代了旧行,而不是 添加了第二个副本. thint -c 告诉你当前外壳是否在终端中运行 .

Windows PowerShell:"运行的脚本在此系统中被禁用". 脚本默认在 Windows PowerShell 5.1 中关闭,它同时停止 thint (没有) thint.ps1)和简介. 运行 thint.cmd init 并说是 当它要求允许脚本,或运行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned 你自己来 您公司制定的政策胜过它; 然后使用 PowerShell 7或"吉特·巴什".

标签以“ 无法启动 ” 打开 . 薄片失败了, 给你留下了平板外壳, 而不是关闭标签 。 信息说为什么; thint reinit 无包装 瘦子的文件又被修复了 大部分都是这样.

在用 pnpm 更新后,新标签仍然启动旧版本. 运行 thint reinit 一次 一次吗 仅从1.1.3及更年长的 pnpm add -g 手持; thint update 为了你.

缩写+ 空格无所事事,或者切换键盘布局. macOS 使用控制+ 当您有多个输入源时可切换空间: 关闭系统中的快捷键 设置QQ键盘QQ键盘快捷键QQ输入源. 在另一个终端, thint debug keys 记录它是什么 发送; 将文件附加到一个问题上.

接受我贝壳的灰色建议 而不是查看文件夹. zsh-自摄取,鱼和PowerShell在光标后显示自己的灰色猜测. 薄薄的只需要... 在一个 在行尾突出显示文件夹; 要将 ~ 总是保留在您的外壳上, 运行 thint config set folderArrows false。 。 。 .

输入运行命令而不是取入. 在一个空格没有选择之后, Enter 运行您输入的内容 。 按 QQ 或 Tab 输入 . thint config set enterRuns true 使 Enter 立即接受条目并运行行.

列表的颜色在 VS 代码中被冲出 . 设定 "terminal.integrated.minimumContrastRatio": 1; VS 代码 否则会改变它绘制的颜色 .

新的标签打开缓慢, 或者在我的配置中的东西运行两次. 薄点在内部开始一个新鲜的外壳,所以起动线上方的任何东西会负载两次. thint doctor 计数这些 线条; thint init 将启动行移回顶部.

老基罗CLI,亚马逊Q或Fig线仍然在我的外壳配置中. thint migrate 把它们取出来,并保存每个文件的副本.

还有一件事. 例如, 在登录时手动启动标签 thint -s zsh -V,做错事,并附加 ~/.local/share/terminalhinter/log/terminalhinter.log (关于窗口) ~\.terminalhinter\log\terminalhinter.log改为: 问题,其中输出 thint doctor。 。 。 .

保存着的东西

什麽何处
设置~/.terminalhinterrc 或者说 ~/.config/terminalhinter/rc.toml (单位:千美元)所有设置(中文(简体) )
您的规格和片段~/.config/terminalhinter/specs/, (中文(简体) ), ~/.config/terminalhinter/snippets.yaml
它学到了什么,日志,自己的文件~/.local/share/terminalhinter (单位:千美元)~/.terminalhinter 在Windows和旧安装上)
启动线顶端 ~/.zshrc, (中文(简体) ), ~/.bashrc, (中文(简体) ), config.fish 或您的动力壳 $PROFILE间 # >>> terminalhinter >>> 财务报告和审定财务报表 # <<< terminalhinter <<<

没有遥测。 你所输入的和所学到的都留在这些文件夹里。 上线只为了抬头看 软件包:一天一次,它要求npm提供它自己最新的版本编号(updateCheck = false 关掉它,当你 键入软件包名称或 react@ 它要求npm注册和npms.io包搜索匹配,只发送该词. 一些列表来自您安装的工具,运行在您的机器上: git分支, docker ps, (中文(简体) ), kubectl get pods, (中文(简体) ), aws s3 ls 给桶名。 仅能达到工具本身所达到的,有你自己的登录.

贷项

一个叉子 微软/微软,带有命令规格 有图片/自动完成. . . . 没有 隶属于微软,亚马逊或Fig.

由艾里克·克兹拉(英语:Eryk Kozyra)所制造. X新闻和新节目: @ erykkozyradev (英语)。 。 。 .

MIT 许可证

版本与发布记录

@erykkozyra/terminalhinter 共发布 12 个版本,首次发布于 2026/11/04;过去 12 个月发布了 12 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.2.2latest2026/11/131 天前
1.2.2-rc.2next2026/11/131 天前
1.2.2-rc.12026/11/131 天前
1.2.12026/11/104 天前
1.2.02026/11/104 天前
1.1.32026/11/059 天前

关于 @erykkozyra/terminalhinter 的常见问题

@erykkozyra/terminalhinter 是什么?

Zsh, bash, fish and PowerShell 的开源终端自动完成 : 文件夹、 git 分支、 npm 脚本和 700+ CLI 等的下拉

如何安装 @erykkozyra/terminalhinter?

在项目目录运行 npm install @erykkozyra/terminalhinter,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 thint、terminalhinter,可以用 npx thint 直接运行。

@erykkozyra/terminalhinter 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/erykkozyra__terminalhinter 是否存在。

@erykkozyra/terminalhinter 可以商用吗?

@erykkozyra/terminalhinter 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@erykkozyra/terminalhinter 的下载量有多少?

根据 npm 官方下载统计,@erykkozyra/terminalhinter 在 2026/10/14 – 2026/11/12 这 30 天内被下载 1,980 次,日均约 66 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@erykkozyra/terminalhinter 还在维护吗?

最新版本 1.2.2 发布于 2026/11/13(1 天前);至今共发布 12 个版本,其中过去 12 个月发布了 12 个;首次发布于 2026/11/04。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。