> For the complete documentation index, see [llms.txt](https://docs.boltai.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.boltai.com/docs/plugins/shell-access.md).

# Shell Access

The Shell Access plugin allows BoltAI to run a bash script on your Mac.

{% hint style="danger" %}
**IMPORTANT**

This plugin is highly experimental. Use it at your own risk.
{% endhint %}

### How to set up the Shell Access plugin?

You can configure the default System PATH in the Settings tab. Default value: `/opt/homebrew/bin/:/usr/local/bin/:/usr/bin:/bin`

### How to use the Shell Access plugin?

1. Start a new chat and select a model that supports Function Calling.
2. Enable the Shell Access plugin.
3. Enter your prompt. Be as specific as possible.

For example, here is how I bulk-rename files using the Shell Access plugin:

<figure><img src="/files/OLGcJrzQUXDmgzNXdAgL" alt=""><figcaption><p>How to use Shell Access plugin in BoltAI</p></figcaption></figure>

### Note

* The Shell Access plugin has full access to your file system. Always verify the script before executing.
* Be as specific as possible in your System Prompt. It's recommended to instruct LLM to limit access to certain files or folders.
* Consider building a [custom MCP Server](/docs/plugins/mcp-servers.md) for specific use case.