@openvole/paw-shell

Shell command execution with safety restrictions.

Part of OpenVole — the microkernel AI agent framework.

Install

npm install @openvole/paw-shell

Config

{
  "name": "@openvole/paw-shell",
  "allow": {
    "filesystem": ["/app/workspace"],
    "env": ["VOLE_SHELL_ALLOWED_DIRS"]
  }
}

Environment Variables

| Variable | Description | |----------|-------------| | VOLE_SHELL_ALLOWED_DIRS | Comma-separated list of directories the shell can access |

Tools

| Tool | Description | |------|-------------| | shell_exec | Run a shell command synchronously and return its output | | shell_exec_background | Run a shell command in the background and return a process ID | | shell_status | Check the status of a background process by its process ID | | shell_kill | Kill a background process by its process ID |

License

MIT