# 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.


---

# 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://docs.boltai.com/docs/plugins/shell-access.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.