@mariozechner/pi-coding-agent 0.19.0 → 0.19.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +15 -0
- package/README.md +68 -1
- package/package.json +4 -4
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,20 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## [0.19.1] - 2025-12-12
|
|
4
|
+
|
|
5
|
+
### Fixed
|
|
6
|
+
|
|
7
|
+
- Documentation: Added skills system documentation to README (setup, usage, CLI flags, settings)
|
|
8
|
+
|
|
9
|
+
## [Unreleased]
|
|
10
|
+
|
|
11
|
+
### Added
|
|
12
|
+
|
|
13
|
+
### Fixed
|
|
14
|
+
|
|
15
|
+
### Changed
|
|
16
|
+
|
|
17
|
+
|
|
3
18
|
## [0.19.0] - 2025-12-12
|
|
4
19
|
|
|
5
20
|
### Added
|
package/README.md
CHANGED
|
@@ -26,7 +26,8 @@ Works on Linux, macOS, and Windows (requires bash; see [Windows Setup](#windows-
|
|
|
26
26
|
- [Custom Models and Providers](#custom-models-and-providers)
|
|
27
27
|
- [Themes](#themes)
|
|
28
28
|
- [Custom Slash Commands](#custom-slash-commands)
|
|
29
|
-
- [
|
|
29
|
+
- [Skills](#skills)
|
|
30
|
+
- [Hooks](#hooks)(#hooks)
|
|
30
31
|
- [Settings File](#settings-file)
|
|
31
32
|
- [CLI Reference](#cli-reference)
|
|
32
33
|
- [Tools](#tools)
|
|
@@ -463,6 +464,68 @@ Usage: `/component Button "onClick handler" "disabled support"`
|
|
|
463
464
|
|
|
464
465
|
**Namespacing:** Subdirectories create prefixes. `.pi/commands/frontend/component.md` → `/component (project:frontend)`
|
|
465
466
|
|
|
467
|
+
|
|
468
|
+
### Skills
|
|
469
|
+
|
|
470
|
+
Skills are instruction files loaded on-demand when tasks match their descriptions. Compatible with Claude Code and Codex CLI skill formats.
|
|
471
|
+
|
|
472
|
+
**Skill locations:**
|
|
473
|
+
- Pi user: `~/.pi/agent/skills/**/*.md` (recursive)
|
|
474
|
+
- Pi project: `.pi/skills/**/*.md` (recursive)
|
|
475
|
+
- Claude Code user: `~/.claude/skills/*/SKILL.md` (one level)
|
|
476
|
+
- Claude Code project: `.claude/skills/*/SKILL.md` (one level)
|
|
477
|
+
- Codex CLI: `~/.codex/skills/**/SKILL.md` (recursive)
|
|
478
|
+
|
|
479
|
+
Later locations win on name collisions (Pi skills override Claude/Codex).
|
|
480
|
+
|
|
481
|
+
**Format:**
|
|
482
|
+
|
|
483
|
+
```markdown
|
|
484
|
+
---
|
|
485
|
+
description: Extract text and tables from PDF files
|
|
486
|
+
---
|
|
487
|
+
|
|
488
|
+
# PDF Processing
|
|
489
|
+
|
|
490
|
+
Use `pdftotext` for plain text extraction.
|
|
491
|
+
For tables, use `tabula-py`.
|
|
492
|
+
|
|
493
|
+
Helper scripts: {baseDir}/scripts/
|
|
494
|
+
```
|
|
495
|
+
|
|
496
|
+
- `description`: Required. Shown in system prompt for agent to decide when to load.
|
|
497
|
+
- `name`: Optional. Overrides filename/directory name.
|
|
498
|
+
- `{baseDir}`: Replaced with skill's directory path.
|
|
499
|
+
|
|
500
|
+
**How it works:**
|
|
501
|
+
|
|
502
|
+
Skills are listed in the system prompt with descriptions:
|
|
503
|
+
|
|
504
|
+
```
|
|
505
|
+
<available_skills>
|
|
506
|
+
- pdf-extract: Extract text and tables from PDF files
|
|
507
|
+
File: ~/.pi/agent/skills/pdf-extract.md
|
|
508
|
+
Base directory: ~/.pi/agent/skills
|
|
509
|
+
</available_skills>
|
|
510
|
+
```
|
|
511
|
+
|
|
512
|
+
Agent uses `read` tool to load full instructions when needed.
|
|
513
|
+
|
|
514
|
+
**Disable skills:**
|
|
515
|
+
|
|
516
|
+
CLI: `pi --no-skills`
|
|
517
|
+
|
|
518
|
+
Settings (`~/.pi/agent/settings.json`):
|
|
519
|
+
```json
|
|
520
|
+
{
|
|
521
|
+
"skills": {
|
|
522
|
+
"enabled": false
|
|
523
|
+
}
|
|
524
|
+
}
|
|
525
|
+
```
|
|
526
|
+
|
|
527
|
+
See [docs/skills.md](docs/skills.md) for details.
|
|
528
|
+
|
|
466
529
|
### Hooks
|
|
467
530
|
|
|
468
531
|
Hooks are TypeScript modules that extend pi's behavior by subscribing to lifecycle events. Use them to:
|
|
@@ -528,6 +591,9 @@ See [Hooks Documentation](docs/hooks.md) for full API reference.
|
|
|
528
591
|
"reserveTokens": 16384,
|
|
529
592
|
"keepRecentTokens": 20000
|
|
530
593
|
},
|
|
594
|
+
"skills": {
|
|
595
|
+
"enabled": true
|
|
596
|
+
},
|
|
531
597
|
"retry": {
|
|
532
598
|
"enabled": true,
|
|
533
599
|
"maxRetries": 3,
|
|
@@ -568,6 +634,7 @@ pi [options] [@files...] [messages...]
|
|
|
568
634
|
| `--tools <tools>` | Comma-separated tool list (default: `read,bash,edit,write`) |
|
|
569
635
|
| `--thinking <level>` | Thinking level: `off`, `minimal`, `low`, `medium`, `high` |
|
|
570
636
|
| `--hook <path>` | Load a hook file (can be used multiple times) |
|
|
637
|
+
| `--no-skills` | Disable skills discovery and loading |
|
|
571
638
|
| `--export <file> [output]` | Export session to HTML |
|
|
572
639
|
| `--help`, `-h` | Show help |
|
|
573
640
|
| `--version`, `-v` | Show version |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mariozechner/pi-coding-agent",
|
|
3
|
-
"version": "0.19.
|
|
3
|
+
"version": "0.19.1",
|
|
4
4
|
"description": "Coding agent CLI with read, bash, edit, write tools and session management",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"piConfig": {
|
|
@@ -39,9 +39,9 @@
|
|
|
39
39
|
"prepublishOnly": "npm run clean && npm run build"
|
|
40
40
|
},
|
|
41
41
|
"dependencies": {
|
|
42
|
-
"@mariozechner/pi-agent-core": "^0.19.
|
|
43
|
-
"@mariozechner/pi-ai": "^0.19.
|
|
44
|
-
"@mariozechner/pi-tui": "^0.19.
|
|
42
|
+
"@mariozechner/pi-agent-core": "^0.19.1",
|
|
43
|
+
"@mariozechner/pi-ai": "^0.19.1",
|
|
44
|
+
"@mariozechner/pi-tui": "^0.19.1",
|
|
45
45
|
"chalk": "^5.5.0",
|
|
46
46
|
"diff": "^8.0.2",
|
|
47
47
|
"glob": "^11.0.3",
|