@justestif/pk 0.1.0 → 0.1.7
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/README.md +11 -2
- package/dist/index.js +8166 -554
- package/package.json +35 -33
- package/skill/SKILL.md +1 -1
package/README.md
CHANGED
|
@@ -15,7 +15,8 @@ Requires [Bun](https://bun.sh).
|
|
|
15
15
|
```bash
|
|
16
16
|
cd your-project
|
|
17
17
|
pk init # Claude Code (default)
|
|
18
|
-
pk init --harness pi # Pi
|
|
18
|
+
pk init --harness pi # Pi
|
|
19
|
+
pk init --harness omp # Oh My Pi
|
|
19
20
|
pk init --harness opencode # OpenCode
|
|
20
21
|
pk init --harness cursor # Cursor
|
|
21
22
|
pk init --harness codex # Codex CLI
|
|
@@ -29,6 +30,7 @@ recent decisions, active notes) automatically into every session.
|
|
|
29
30
|
|---|---|---|
|
|
30
31
|
| `claude` | `UserPromptSubmit` hook | `.claude/hooks/pk-*.ts` + `settings.json` |
|
|
31
32
|
| `pi` | `before_agent_start` extension | `.pi/extensions/pk.ts` |
|
|
33
|
+
| `omp` | `before_agent_start` hook | `.omp/extensions/pk.ts` |
|
|
32
34
|
| `opencode` | `experimental.chat.system.transform` | `.opencode/plugins/pk.ts` |
|
|
33
35
|
| `cursor` | Agent rule | `.cursor/rules/pk.mdc` |
|
|
34
36
|
| `codex` | `AGENTS.md` block | `AGENTS.md` |
|
|
@@ -37,7 +39,8 @@ recent decisions, active notes) automatically into every session.
|
|
|
37
39
|
|
|
38
40
|
```bash
|
|
39
41
|
pk new <type> <title> [--tags tag1,tag2]
|
|
40
|
-
pk search <query> [--context] [--limit 5]
|
|
42
|
+
pk search <query> [--context] [--limit 5] [--type] [--status] [--tag]
|
|
43
|
+
pk vocab [--json]
|
|
41
44
|
pk synthesize [query] [--all] [--session-start]
|
|
42
45
|
pk index
|
|
43
46
|
pk lint
|
|
@@ -52,6 +55,7 @@ pk instructions <command>
|
|
|
52
55
|
| `decision` | Chosen direction with rationale and consequences |
|
|
53
56
|
| `question` | Unresolved uncertainty that blocks or informs work |
|
|
54
57
|
| `source` | Raw input preserved for provenance |
|
|
58
|
+
| `index` | Navigation/map-of-content over a topic or tag |
|
|
55
59
|
|
|
56
60
|
### Example
|
|
57
61
|
|
|
@@ -79,8 +83,13 @@ knowledge/
|
|
|
79
83
|
```
|
|
80
84
|
|
|
81
85
|
Search is powered by SQLite FTS5 with BM25 ranking and porter stemming.
|
|
86
|
+
Partial word matching works — `pk search migr` matches "migration", "migrate", etc.
|
|
87
|
+
Matching body context is shown under each result.
|
|
82
88
|
The index is a derived artifact — delete it and run `pk index` to rebuild.
|
|
83
89
|
|
|
90
|
+
`pk vocab` lists all tags in the knowledge base by frequency. Useful for orienting
|
|
91
|
+
an agent before searching, without loading full note content.
|
|
92
|
+
|
|
84
93
|
## Agent hook
|
|
85
94
|
|
|
86
95
|
`pk init` installs `.claude/hooks/pk-user-prompt-submit.ts` and registers it
|