| name | windows-agent-tooling |
| description | Native Windows agent workflows — PowerShell, winget, Cursor IDE, Docker Desktop, when WSL is optional. |
Windows agent tooling
Purpose
Effective agent work on Windows host without unnecessary WSL hops.
When to Use
- User workspace is native Windows
- Simple search, edit, gh, uv, pnpm tasks
- Docker Desktop on Windows
Required Tools
PowerShell, git, rg, fd, gh, optional Docker Desktop.
Install
Install blocks are shared — See install-blocks.md.
Windows PowerShell
Use winget blocks from the reference when provisioning a new machine.
WSL2 Ubuntu
Use apt/curl blocks from the reference; symlink fdfind → fd if needed.
macOS
Use Homebrew blocks from the reference.
Common Commands
git status --short
rg "pattern" . --glob '!node_modules' -n --max-count 30
fd -e md .
Get-Content .\README.md -TotalCount 80
gh pr list --limit 10
Host / WSL split
Windows host:
Cursor / VS Code / Claude Desktop / Docker Desktop / local LLM apps
Simple rg/fd, GitHub CLI, uv/pnpm on native paths
WSL2 Ubuntu:
repositories (optional), ast-grep, MCP stdio servers, CI-like tests
When native Windows is enough: simple search, editing, GitHub CLI, Python with uv, Node with pnpm.
When WSL2 is better: Bash-heavy repos, Docker Compose Linux paths, MCP Unix servers, monorepo CI parity.
Full diagram: windows-wsl-split.md.
Agent-Safe Patterns
Commands Requiring Confirmation
See commands-requiring-confirmation.md.
Troubleshooting
- Execution policy blocking scripts: user adjusts policy for their profile.
- Docker not running: start Docker Desktop before compose commands.
Windows Notes
- Primary environment for this skill.
- Optional fff-mcp at
%LOCALAPPDATA%\fff-mcp\bin\fff-mcp.exe.
WSL2 Notes
Verification Checklist