mirror of
https://github.com/getcompanion-ai/co-mono.git
synced 2026-04-15 18:01:22 +00:00
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:
parent
a8d04a1dbf
commit
7a0b435923
4 changed files with 13 additions and 2 deletions
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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 |
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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"]
|
||||
}
|
||||
```
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue