docs(coding-agent): add security warnings for third-party packages

- README.md: Pi Packages section
- packages.md: Install and Manage section
- extensions.md: Extension Locations section
- skills.md: Locations section
This commit is contained in:
Mario Zechner 2026-01-26 12:38:04 +01:00
parent a8d04a1dbf
commit 7a0b435923
4 changed files with 13 additions and 2 deletions

View file

@ -319,6 +319,8 @@ Place in `~/.pi/agent/themes/`, `.pi/themes/`, or a [pi package](#pi-packages) t
Bundle and share extensions, skills, prompts, and themes via npm or git. Find packages on [npmjs.com](https://www.npmjs.com/search?q=keywords%3Api-package) or [Discord](https://discord.com/channels/1456806362351669492/1457744485428629628).
> **Security:** Pi packages run with full system access. Extensions execute arbitrary code, and skills can instruct the model to perform any action including running executables. Review source code before installing third-party packages.
```bash
pi install npm:@foo/pi-tools
pi install npm:@foo/pi-tools@1.2.3 # pinned version

View file

@ -103,6 +103,8 @@ pi -e ./my-extension.ts
## Extension Locations
> **Security:** Extensions run with your full system permissions and can execute arbitrary code. Only install from sources you trust.
Extensions are auto-discovered from:
| Location | Scope |

View file

@ -16,6 +16,8 @@ Pi packages bundle extensions, skills, prompt templates, and themes so you can s
## Install and Manage
> **Security:** Pi packages run with full system access. Extensions execute arbitrary code, and skills can instruct the model to perform any action including running executables. Review source code before installing third-party packages.
```bash
pi install npm:@foo/bar@1.0.0
pi install git:github.com/user/repo@v1
@ -139,10 +141,13 @@ Filter what a package loads using the object form in settings:
}
```
`+path` and `-path` are exact paths relative to the package root.
- Omit a key to load all of that type.
- Use `[]` to load none of that type.
- `!pattern` excludes matches.
- `+pattern` force-includes, even if excluded by manifest.
- `+path` force-includes an exact path.
- `-path` force-excludes an exact path.
- Filters layer on top of the manifest. They narrow down what is already allowed.
## Enable and Disable Resources

View file

@ -19,6 +19,8 @@ Pi implements the [Agent Skills standard](https://agentskills.io/specification),
## Locations
> **Security:** Skills can instruct the model to perform any action and may include executable code the model invokes. Review skill content before use.
Pi loads skills from:
- Global: `~/.pi/agent/skills/`
@ -50,7 +52,7 @@ For project-level Claude Code skills, add to `.pi/settings.json`:
```json
{
"skills": [".claude/skills"]
"skills": ["../.claude/skills"]
}
```