# 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="https://3493584844-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FynYW2xZqA52spY7XgWis%2Fuploads%2FALGrePbDcn40iD2HbXKp%2FCleanShot%202025-04-29%20at%2015.38.00%402x.jpg?alt=media&#x26;token=77809a33-0f05-4b56-9813-747cb4fcdc45" 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](https://docs.boltai.com/docs/plugins/mcp-servers) for specific use case.