Instruction file imported from sillsdev/FieldWorks (
.github/instructions/terminal.instructions.md). Copyright stays with the author.
Terminal Commands
Commands with pipes (|), &&, or 2>&1 require manual approval. Use repository wrapper scripts instead.
Placement policy for wrappers:
- Prefer
Build/Agent/for new build/test/CI orchestration scripts.
MCP-first: When the ps-tools MCP server is running, prefer MCP tools (Git-Search, Read-FileContent, Invoke-AgentTask, build, test, agent tools) instead of direct terminal commands. Use wrappers only when MCP is unavailable.
Task-first for CI parity: Prefer the existing VS Code tasks CI: Whitespace check, CI: Commit messages, and CI: Full local check over ad-hoc shell commands. These tasks are already allowed for agent use and match the repository CI checks.
Transformations
| ❌ Blocked | ✅ Use Instead |
|---|---|
git log | head -20 |
.\scripts\Agent\Git-Search.ps1 -Action log -HeadLines 20 |
git show ref:file | head -50 |
.\scripts\Agent\Git-Search.ps1 -Action show -Ref "ref" -Path "file" -HeadLines 50 |
git diff ref -- path |
.\scripts\Agent\Git-Search.ps1 -Action diff -Ref "ref" -Path "path" |
Get-Content file | Select -First N |
.\scripts\Agent\Read-FileContent.ps1 -Path "file" -HeadLines N |
Get-Content file | Select-String pat |
.\scripts\Agent\Read-FileContent.ps1 -Path "file" -Pattern "pat" |
Scripts
| Script | Purpose |
|---|---|
Git-Search.ps1 |
git show/diff/log/grep/blame |
Read-FileContent.ps1 |
File reading with filtering |
Build/test: Run .\build.ps1 or .\test.ps1 directly—they're auto-approvable.