# PermShell

> Use this tool when you need to execute shell commands with user permission and transparency, or retrieve system information while maintaining strong security boundaries. PermShell enables AI assistants to run commands through desktop notifications, ensuring explicit user approval for each execution. It provides a secure interface for controlled access to local systems, making it ideal for use cases requiring balanced functionality and security.

Canonical page: https://skillsregistry.net/skills/mcollina-perm-shell  
JSON: https://api.skillsregistry.net/v1/skills/mcollina-perm-shell

## Description

PermShell MCP is a TypeScript server that enables AI assistants to execute shell commands with explicit user permission through desktop notifications. Developed by Matteo Collina, it implements a security-focused approach where all commands require user approval via growl notifications that display the exact command and working directory for transparency. The server provides two main tools: 'execute-command' for running shell commands with permission safeguards and 'system-info' for retrieving system information without requiring explicit permission. It's particularly useful for scenarios where AI assistants need controlled access to the local system while maintaining strong security boundaries.

## Trust

- **Trust score (0–1):** 1.00
- **Verification tier:** verified
- **Last scanned:** 2026-09-28

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** security
- **Updated:** 2026-09-28

## Source

- **Source listing:** [PulseMCP](https://www.pulsemcp.com/servers/mcollina-perm-shell)
- **Repository:** <https://github.com/mcollina/perm-shell-mcp>

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "mcollina-perm-shell"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/mcollina-perm-shell` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/mcollina-perm-shell/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt