# Run Command

The Run Command Tool enables AI models to execute shell commands on macOS. This functionality allows tasks to be performed by simply describing the desired action, without the need to recall specific commands. The AI processes the request and executes the appropriate shell commands.

## $PATH

The Run Command tool relies heavily on the $PATH configuration, which enables it to access installed applications and extend its functionalities.

{% hint style="info" %}
To grant SUPgpt access to all commands on your system, follow these steps:

1\. Open the Terminal.

2\. Type echo $PATH and press Enter.

3\. Copy the output.

4\. Paste it into the $PATH field in either the App Settings or the Chat Settings.
{% endhint %}

## Limitations

Run Command cannot execute commands that require user input. For example, commands that prompt for confirmation, such as `Do you want to continue Y/n`, will cause the tool to run indefinitely. 

If encountering such a command, the process can be terminated by clicking the stop button in the prompt field, which will instantly kill the running process.

<figure><img src="/files/oM0ZuhQlfowmJK97n4bC" alt=""><figcaption></figcaption></figure>

## Some "Run Command" Uses

* Run python code
* Initialize node.js projects
* Use FFmpeg for video processing
* Resize and convert images
* Download files
* Retrieve system information
* Use available installed interpreters
* Make API calls
* Zip files
* Search for files
* Manage packages
* Perform file operations
* Check network status
* Create and manage virtual environments
* Monitor system resources
* Schedule tasks
* Generate SSH keys
* Compile code
* Run Docker containers
* And more


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://macdocs.supgpt.app/tools/run-command.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.