Terminal Execution Guidelines

This skill defines the standard workflows for executing terminal commands to ensure reliability and visibility of outputs, particularly in complex environments like WSL.

1. Primary Execution Method

Always prioritize structured execution tools over raw terminal input when possible.

1. Use execute_command: Call the execute_command tool from the terminal-runner MCP server. This provides the most reliable way to get exit codes and standard output programmatically.
2. Fallback: If terminal-runner is unavailable, use the standard run_in_terminal tool.

2. Handling Missing Output (WSL/Complex Environments)

In some environments (like WSL), terminal output may not be returned to the agent context correctly, or it may be truncated. If you suspect output is missing:

File-Based Capture Workflow