Skip to content
This repository was archived by the owner on Sep 23, 2026. It is now read-only.

feat(shell): enhance shell tool with version-aware PowerShell context #1135

Open
QIN2DIM wants to merge 7 commits into
base: main
Choose a base branch
from
Open

feat(shell): enhance shell tool with version-aware PowerShell context #1135

Changes from 1 commit
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
01fa9fa
feat(shell): enhance shell tool with version-aware documentation
QIN2DIM Feb 13, 2026
4348a1c
Create powershell.md
QIN2DIM Feb 13, 2026
63f9fbe
Update powershell.md
QIN2DIM Feb 13, 2026
29832cb
Update __init__.py
QIN2DIM Feb 13, 2026
484b367
Update src/kimi_cli/utils/environment.py
QIN2DIM Feb 13, 2026
16eae75
Update environment.py
QIN2DIM Feb 13, 2026
ac0047d
test: fix pyinstaller snapshot for new shell files
QIN2DIM Feb 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Create powershell.md
  • Loading branch information
@QIN2DIM
QIN2DIM committed Feb 13, 2026
commit 4348a1c77c04e2d988681928371e4e321979cba6
28 changes: 28 additions & 0 deletions src/kimi_cli/tools/shell/powershell.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
Execute a ${SHELL} command. Use this tool to explore the filesystem, inspect or edit files, run Windows scripts, collect system information, etc., whenever the agent is running on Windows.

Note that you are running on Windows with **PowerShell**, so make sure to use PowerShell commands, paths, and conventions. Do NOT use CMD-style commands or syntax.

**Output:**
The stdout and stderr streams are combined and returned as a single string. Extremely long output may be truncated. When a command fails, the exit code is provided in a system tag.

**Guidelines for safety and security:**
- Every tool call starts a fresh ${SHELL} session. Environment variables, `cd` changes, and command history do not persist between calls.
- Do not launch interactive programs or anything that is expected to block indefinitely; ensure each command finishes promptly. Provide a `timeout` argument for potentially long runs.
- Avoid using `..` to leave the working directory, and never touch files outside that directory unless explicitly instructed.
- Never attempt commands that require elevated (Administrator) privileges unless explicitly authorized.

**Guidelines for efficiency:**
- Chain related commands with `&&` (PS 7+) or use `if ($LASTEXITCODE -eq 0)` to conditionally execute commands based on the success or failure of previous ones.
- Redirect or pipe output with `>`, `>>`, `|`, and leverage PowerShell cmdlets like `Select-String`, `Where-Object`, `ForEach-Object` to build richer one-liners instead of multiple tool calls.
- Use native PowerShell parameters (dash-prefixed like `-Name`, `-Path`); do NOT use CMD-style slash parameters (e.g., use `Get-ChildItem -Name` instead of `dir /b`).

**PowerShell cmdlets available:**
- File/Directory: `Get-ChildItem` (aliases: dir/ls), `New-Item`, `Copy-Item`, `Move-Item`, `Remove-Item`, `Get-Content` (alias: cat), `Set-Content`, `Add-Content`, `Test-Path`
- Environment: `$env:VARNAME` syntax, `Set-Variable`, `Get-Variable`
- Text/Search: `Select-String` (grep-like), `Where-Object`, `Sort-Object`, `Out-File`
- System info: `Get-ComputerInfo`, `Get-Process`, `Get-Service`, `hostname`, `systeminfo` (external)
- Archives/Scripts: `tar`, `Compress-Archive`, `Expand-Archive`, `powershell`, `python`, `node`
- Other: Any other binaries available on the system PATH; run `Get-Command <name>` to verify availability.

**Note on aliases:**
PowerShell provides aliases like `dir`, `ls`, `cat`, `rm`, `cd` for convenience, but they behave differently from CMD/Unix equivalents. For example, `dir /b` will NOT work in PowerShell. Prefer native cmdlet names with dash-prefixed parameters for predictable behavior.
Loading