Configurable Shell Support for Windows: Allow bash (Git Bash/MSYS2/Cygwin) instead of PowerShell

[HamzaETTH]

What feature would you like to see?

On Windows, kimi-cli currently hardcodes PowerShell as the shell for executing commands. This causes significant issues because:

1. LLMs are trained primarily on bash syntax - Most LLMs generate bash commands by default
2. Common bash patterns fail in PowerShell:
   • ls -la && cat file.txt → Error: '&&' is not a valid statement separator
   • export VAR=value → Error: export is not recognized
   • cat file | grep pattern → Pipeline syntax differs
3. Standard Unix tools unavailable - PowerShell lacks grep, awk, sed, ls by default

Proposed Solution

Add a [shell] configuration section to ~/.kimi/config.toml with hybrid detection:

Priority order:

1. Explicit path (shell.path)
2. SHELL environment variable (Git Bash sets this)
3. Auto-detect based on shell.preferred setting
4. PowerShell fallback (backwards compatible)

Example config:

  [shell]
  path = "C:/Program Files/Git/bin/bash.exe"
  # OR
  preferred = "bash"  # "auto" (default), "powershell", "bash"

Benefits

• LLM-generated bash commands work correctly
• Cross-platform consistency
• Zero-config for Git Bash users (just launch from Git Bash)
• Backwards compatible (default unchanged)

──────────────────────────────────────────────────────────────────────

Additional information

No response

[lzy17553710908]

背景

刚刚升级到 1.42.0 版本后，在 Windows 上运行 kimi-cli 时遇到了以下错误：

kimi-cli on Windows requires Git for Windows (https://git-scm.com/downloads/win) 
for its bundled bash. If git-bash is installed but not on PATH, set the 
KIMI_CLI_GIT_BASH_PATH environment variable to your bash.exe

问题

1.42.0 版本将 Windows shell 后端从 PowerShell 切换到了 Git Bash，这是一个很好的改进！但缺少前置依赖的提前检测和安装引导，导致升级后直接使用时报错。

建议

1. 安装脚本检测：在 install.ps1 安装/升级脚本中检测 Git for Windows 是否已安装，如未安装则给出友好提示
2. VS Code 扩展提示：VS Code 扩展在检测到 CLI 版本升级时，如缺少 Git Bash 依赖，给出通知引导
3. 错误信息优化：错误提示中直接给出一键安装命令，如：

   # 建议添加：
   winget install --id Git.Git -e --source winget
   # 或
   choco install git

4. 文档更新：在 Getting Started 文档的 Windows 安装部分添加 Git for Windows 作为前置依赖

环境

• OS: Windows 10/11
• kimi-cli version: 1.42.0
• 安装方式：irm https://code.kimi.com/install.ps1 | iex

临时解决方案（已验证可行）

安装 Git for Windows 后问题解决：https://git-scm.com/downloads/win

---

感谢团队的持续改进！1.42.0 切换到 Git Bash 后的体验确实比之前 PowerShell 好很多 👍