Skip to content

Commit 0faf5e4

Browse files
refactor: Rebrand from kai-* to pai-* naming across all packs
Major changes: - Rename all 10 packs from kai-* to pai-* prefix - Rename Bundles/Kai → Bundles/Official (PAI Bundle v2.1.0) - Add new pai-upgrades-skill pack with 30+ Anthropic sources - Update all internal references and icons - Maintain mention of Kai origin in bundle README New pai-upgrades-skill features: - Monitor Anthropic blogs, GitHub repos, changelogs, docs - YouTube channel monitoring via customization layer - ReleaseNotesDeepDive workflow for parallel feature research - Prioritized upgrade roadmap generation Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 6cfdc0a commit 0faf5e4

169 files changed

Lines changed: 2284 additions & 1591 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
Lines changed: 37 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,16 @@
11
<p align="center">
2-
<img src="kai.png" alt="The Official PAI (Kai) Bundle" width="256">
2+
<img src="pai-bundle.png" alt="The Official PAI Bundle" width="256">
33
</p>
44

5-
# The Official PAI (Kai) Bundle v2.0.0
5+
# The Official PAI Bundle v2.1.0
66

7-
> **FOR AI AGENTS:** You are about to install the complete Kai bundle. Run the wizard, then install each pack in order.
7+
> **FOR AI AGENTS:** You are about to install the complete PAI bundle. Run the wizard, then install each pack in order.
8+
9+
**Origin:** This bundle is extracted from Daniel Miessler's production Kai system - a battle-tested Personal AI Infrastructure that has been refined through daily use since 2024.
810

911
---
1012

11-
## 🚨 CRITICAL: Full Implementation Required (For AI Agents)
13+
## CRITICAL: Full Implementation Required (For AI Agents)
1214

1315
> **MANDATORY: Read this section before installing ANY pack in this bundle.**
1416
@@ -43,13 +45,13 @@ AI agents systematically create "simplified" versions of pack implementations. I
4345
**After ALL packs are installed, confirm:**
4446

4547
```markdown
46-
## Kai Bundle Installation Complete
48+
## PAI Bundle Installation Complete
4749

4850
### Pack Status
49-
- [ ] kai-hook-system - FULLY installed, verified
50-
- [ ] kai-history-system - FULLY installed, verified
51-
- [ ] kai-core-install - FULLY installed, verified
52-
- [ ] kai-voice-system - FULLY installed, verified (if applicable)
51+
- [ ] pai-hook-system - FULLY installed, verified
52+
- [ ] pai-history-system - FULLY installed, verified
53+
- [ ] pai-core-install - FULLY installed, verified
54+
- [ ] pai-voice-system - FULLY installed, verified (if applicable)
5355

5456
### Integration Status
5557
- [ ] ~/.claude directory structure correct
@@ -110,7 +112,7 @@ Update mode will:
110112

111113
## What This Bundle Provides
112114

113-
When fully installed, the Kai bundle gives you:
115+
When fully installed, the PAI bundle gives you:
114116

115117
- A custom **History system** - Automatically captures sessions, decisions, learnings, and research
116118
- A custom set of **Hooks** - Event-driven automation that triggers on session start, tool use, and task completion
@@ -127,21 +129,23 @@ When fully installed, the Kai bundle gives you:
127129

128130
| # | Pack | Purpose | Dependencies |
129131
|---|------|---------|--------------|
130-
| 1 | [kai-hook-system](../../Packs/kai-hook-system/) | Event-driven automation | None |
131-
| 2 | [kai-history-system](../../Packs/kai-history-system/) | Memory and capture | Hooks |
132-
| 3 | [kai-core-install](../../Packs/kai-core-install/) | Skills + Identity + Architecture | Hooks, History |
133-
| 4 | [kai-prompting-skill](../../Packs/kai-prompting-skill/) | Meta-prompting & templates | Core |
134-
| 5 | [kai-voice-system](../../Packs/kai-voice-system/) | Voice notifications (optional) | Hooks, Core |
135-
| 6 | [kai-agents-skill](../../Packs/kai-agents-skill/) | Dynamic agent composition (optional) | Core, Voice (optional) |
136-
| 7 | [kai-art-skill](../../Packs/kai-art-skill/) | Visual content generation (optional) | Core |
137-
| 8 | [kai-observability-server](../../Packs/kai-observability-server/) | Multi-agent monitoring (optional) | Hooks |
132+
| 1 | [pai-hook-system](../../Packs/pai-hook-system/) | Event-driven automation | None |
133+
| 2 | [pai-history-system](../../Packs/pai-history-system/) | Memory and capture | Hooks |
134+
| 3 | [pai-core-install](../../Packs/pai-core-install/) | Skills + Identity + Architecture | Hooks, History |
135+
| 4 | [pai-prompting-skill](../../Packs/pai-prompting-skill/) | Meta-prompting & templates | Core |
136+
| 5 | [pai-voice-system](../../Packs/pai-voice-system/) | Voice notifications (optional) | Hooks, Core |
137+
| 6 | [pai-agents-skill](../../Packs/pai-agents-skill/) | Dynamic agent composition (optional) | Core, Voice (optional) |
138+
| 7 | [pai-art-skill](../../Packs/pai-art-skill/) | Visual content generation (optional) | Core |
139+
| 8 | [pai-observability-server](../../Packs/pai-observability-server/) | Multi-agent monitoring (optional) | Hooks |
140+
| 9 | [pai-upgrades-skill](../../Packs/pai-upgrades-skill/) | Track and implement system upgrades (optional) | Core |
141+
| 10 | [pai-browser-skill](../../Packs/pai-browser-skill/) | Browser automation (optional) | Core |
138142

139143
### How to Install Packs
140144

141145
Give each pack directory to your AI and ask it to install:
142146

143147
```
144-
"Install the kai-hook-system pack from PAI/Packs/kai-hook-system/"
148+
"Install the pai-hook-system pack from PAI/Packs/pai-hook-system/"
145149
```
146150

147151
The AI will:
@@ -213,15 +217,15 @@ mv ~/.claude-BACKUP ~/.claude
213217
- `VERIFY.md` - Mandatory verification checklist
214218
- `src/` - Actual source code files (TypeScript, YAML, etc.)
215219

216-
For example, `kai-hook-system` provides an entire event-driven automation framework with all code files ready to copy.
220+
For example, `pai-hook-system` provides an entire event-driven automation framework with all code files ready to copy.
217221

218-
**Bundles** are curated combinations of packs designed to work together. The Kai Bundle is 8 packs that form a complete AI infrastructure (4 required + 4 optional).
222+
**Bundles** are curated combinations of packs designed to work together. The Official PAI Bundle is 10 packs that form a complete AI infrastructure (4 required + 6 optional).
219223

220224
---
221225

222226
## The 14 Founding Principles
223227

224-
The Kai system embeds these principles from [PAI](https://danielmiessler.com/blog/personal-ai-infrastructure):
228+
The PAI system embeds these principles from [Personal AI Infrastructure](https://danielmiessler.com/blog/personal-ai-infrastructure):
225229

226230
1. **Clear Thinking + Prompting is King** - Good prompts come from clear thinking
227231
2. **Scaffolding > Model** - Architecture matters more than which model
@@ -231,22 +235,29 @@ The Kai system embeds these principles from [PAI](https://danielmiessler.com/blo
231235
6. **UNIX Philosophy** - Do one thing well, make tools composable
232236
7. **ENG / SRE Principles** - Treat AI infrastructure like production software
233237
8. **CLI as Interface** - Command-line is faster and more reliable
234-
9. **Goal Code CLI Prompts Agents** - The decision hierarchy
238+
9. **Goal -> Code -> CLI -> Prompts -> Agents** - The decision hierarchy
235239
10. **Meta / Self Update System** - Encode learnings so you never forget
236240
11. **Custom Skill Management** - Modular capabilities that route intelligently
237241
12. **Custom History System** - Everything worth knowing gets captured
238242
13. **Custom Agent Personalities** - Different work needs different approaches
239-
14. **Science as Cognitive Loop** - Hypothesis Experiment Measure Iterate
243+
14. **Science as Cognitive Loop** - Hypothesis -> Experiment -> Measure -> Iterate
240244

241245
---
242246

243247
## Changelog
244248

249+
### 2.1.0 - 2026-01-08
250+
- **Rebranded to PAI:** All packs renamed from pai-* to pai-* for consistency with project name
251+
- **New Pack:** Added pai-upgrades-skill for tracking Anthropic ecosystem updates
252+
- **New Pack:** Added pai-browser-skill for web automation and verification
253+
- **Bundle renamed:** "Kai Bundle" -> "Official PAI Bundle"
254+
- **Origin preserved:** Bundle documentation notes extraction from Daniel Miessler's Kai system
255+
245256
### 2.0.0 - 2025-12-31
246257
- **Directory-based Packs:** All packs migrated from single markdown files to directory structure
247258
- **New Pack Format:** Each pack now contains README.md, INSTALL.md, VERIFY.md, and src/ directory
248259
- **Actual Code Files:** Source code now in real .ts, .yaml, .hbs files (not embedded in markdown)
249-
- **Four New Packs:** Added kai-prompting-skill, kai-agents-skill, kai-art-skill, kai-observability-server
260+
- **Four New Packs:** Added pai-prompting-skill, pai-agents-skill, pai-art-skill, pai-observability-server
250261
- **Improved Installation:** AI agents copy actual files instead of extracting from markdown blocks
251262

252263
### 1.2.0 - 2025-12-30
@@ -271,4 +282,4 @@ The Kai system embeds these principles from [PAI](https://danielmiessler.com/blo
271282
## Credits
272283

273284
**Author:** Daniel Miessler
274-
**Origin:** Extracted from production Kai system (2024-2025)
285+
**Origin:** Extracted from production Kai system (2024-2026)

Bundles/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ A **bundle** is a curated collection of PAI packs designed to work together as a
6565
- `VERIFY.md` - Mandatory verification checklist
6666
- `src/` - Actual source code files (TypeScript, YAML, etc.)
6767

68-
For example, `kai-hook-system` provides an entire event-driven automation framework with all code files ready to copy.
68+
For example, `pai-hook-system` provides an entire event-driven automation framework with all code files ready to copy.
6969

7070
**Bundles** are combinations of packs that work exceptionally well together—a harmonious system from a single author or unified around a single theme. The packs in a bundle were designed to integrate seamlessly, creating emergent capabilities greater than the sum of their parts.
7171

INSTALL.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -94,17 +94,17 @@ Explain the concepts of Bundles and Packs:
9494
> Bundles are curated collections of packs that work well together. Instead of choosing packs one-by-one, a bundle gives you a complete, tested experience.
9595
9696
**Ask: How would you like to proceed?**
97-
- **Install the Kai Bundle** (Recommended) — The complete PAI experience with all core capabilities
97+
- **Install the PAI Bundle** (Recommended) — The complete PAI experience with all core capabilities
9898
- **Browse individual packs** — Choose specific capabilities you want
9999
- **Minimal install** — Just the basics to get started
100100

101101
---
102102

103-
#### Phase 4: The Kai Bundle (If Selected)
103+
#### Phase 4: The PAI Bundle (If Selected)
104104

105-
If they chose the Kai Bundle, explain what's included:
105+
If they chose the PAI Bundle, explain what's included:
106106

107-
**The Kai Bundle includes:**
107+
**The PAI Bundle includes:**
108108

109109
| Pack | What It Does |
110110
|------|--------------|
@@ -114,7 +114,7 @@ If they chose the Kai Bundle, explain what's included:
114114
| **Voice System** | Spoken notifications via text-to-speech |
115115
| **Browser Skill** | Web automation for testing and verification |
116116

117-
**Ask: Ready to install the Kai Bundle?**
117+
**Ask: Ready to install the PAI Bundle?**
118118
- Yes, install everything
119119
- Tell me more about each pack first
120120
- I want to customize which packs to include
@@ -131,11 +131,11 @@ For each pack being installed:
131131
4. **Confirm success** before moving to the next pack
132132

133133
**Installation order matters.** Install in this sequence:
134-
1. kai-hook-system (foundation)
135-
2. kai-core-install (identity and routing)
136-
3. kai-history-system (memory)
137-
4. kai-voice-system (optional)
138-
5. kai-browser-skill (optional)
134+
1. pai-hook-system (foundation)
135+
2. pai-core-install (identity and routing)
136+
3. pai-history-system (memory)
137+
4. pai-voice-system (optional)
138+
5. pai-browser-skill (optional)
139139

140140
---
141141

@@ -180,8 +180,8 @@ If you prefer to install PAI yourself without AI assistance:
180180
git clone https://github.com/danielmiessler/PAI.git
181181
cd PAI
182182

183-
# Run the Kai Bundle installer
184-
cd Bundles/Kai
183+
# Run the PAI Bundle installer
184+
cd Bundles/Official
185185
bun run install.ts
186186
```
187187

@@ -197,7 +197,7 @@ Each pack in `Packs/` has its own installation:
197197

198198
```bash
199199
# Example: Install just the history system
200-
cd Packs/kai-history-system
200+
cd Packs/pai-history-system
201201
# Read INSTALL.md and follow instructions
202202
# Or give the directory to your AI
203203
```

PACKS.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,7 @@ Skill packs are invoked BY the AI when it detects relevant triggers.
7575

7676
System packs are installed BY humans and provide infrastructure. They are NOT incomplete for lacking SKILL.md - that's by design.
7777

78-
**System packs:** kai-hook-system, kai-history-system, kai-voice-system, kai-observability-server
78+
**System packs:** pai-hook-system, pai-history-system, pai-voice-system, pai-observability-server
7979

8080
---
8181

@@ -88,7 +88,7 @@ System packs are installed BY humans and provide infrastructure. They are NOT in
8888
- Agent orchestration (multi-agent coordination)
8989
- Hook systems (event-driven automation)
9090

91-
**Example:** The Kai History System pack adds automatic context-tracking with 4 hooks, 3 library files, and complete settings.json configuration.
91+
**Example:** The PAI History System pack adds automatic context-tracking with 4 hooks, 3 library files, and complete settings.json configuration.
9292

9393
### Skill Packs
9494

@@ -255,23 +255,23 @@ Browse all packs: [Packs/](Packs/)
255255

256256
| Pack | Type | Description |
257257
|------|------|-------------|
258-
| [kai-hook-system](Packs/kai-hook-system.md) | Foundation | Event-driven automation framework for hook-based capabilities |
259-
| [kai-history-system](Packs/kai-history-system.md) | Infrastructure | Automatic context-tracking for all work, decisions, and learnings |
260-
| [kai-core-install](Packs/kai-core-install.md) | Core | Skills + Identity + Architecture - complete foundation pack |
261-
| [kai-voice-system](Packs/kai-voice-system.md) | Notifications | Voice output with ElevenLabs TTS and prosody enhancement |
262-
| [kai-observability-server](Packs/kai-observability-server.md) | Observability | Real-time multi-agent monitoring dashboard |
258+
| [pai-hook-system](Packs/pai-hook-system.md) | Foundation | Event-driven automation framework for hook-based capabilities |
259+
| [pai-history-system](Packs/pai-history-system.md) | Infrastructure | Automatic context-tracking for all work, decisions, and learnings |
260+
| [pai-core-install](Packs/pai-core-install.md) | Core | Skills + Identity + Architecture - complete foundation pack |
261+
| [pai-voice-system](Packs/pai-voice-system.md) | Notifications | Voice output with ElevenLabs TTS and prosody enhancement |
262+
| [pai-observability-server](Packs/pai-observability-server.md) | Observability | Real-time multi-agent monitoring dashboard |
263263

264264
### Skill Packs
265265

266266
| Pack | Type | Description |
267267
|------|------|-------------|
268-
| [kai-art-skill](Packs/kai-art-skill.md) | Skill | Visual content generation with charcoal architectural sketch aesthetic |
269-
| [kai-agents-skill](Packs/kai-agents-skill.md) | Skill | Dynamic agent composition with specialized personalities and voices |
270-
| [kai-prompting-skill](Packs/kai-prompting-skill.md) | Skill | Meta-prompting system for programmatic prompt generation |
268+
| [pai-art-skill](Packs/pai-art-skill.md) | Skill | Visual content generation with charcoal architectural sketch aesthetic |
269+
| [pai-agents-skill](Packs/pai-agents-skill.md) | Skill | Dynamic agent composition with specialized personalities and voices |
270+
| [pai-prompting-skill](Packs/pai-prompting-skill.md) | Skill | Meta-prompting system for programmatic prompt generation |
271271

272272
**Installation order:** hooks → history → core-install → voice → observability (optional) → skill packs
273273

274-
**Or install the complete [Kai Bundle](Bundles/Kai/)** which handles ordering automatically.
274+
**Or install the complete [PAI Bundle](Bundles/Official/)** which handles ordering automatically.
275275

276276
---
277277

PLATFORM.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -23,18 +23,18 @@ This document tracks all platform-specific code and dependencies across PAI, pro
2323

2424
**Critical Blockers:**
2525
1.`sed -i ''` syntax (macOS BSD vs GNU sed)
26-
- **File:** `Packs/kai-voice-system/INSTALL.md` line 337
26+
- **File:** `Packs/pai-voice-system/INSTALL.md` line 337
2727
- **Fix:** Platform-aware sed with USERNAME fallback
2828
- **Status:** Fixed with conditional `uname -s` detection
2929

3030
2.`/opt/homebrew/bin` hardcoded in PATH
31-
- **Files:** `kai-observability-server/src/observability/manage.sh:8`, `kai-observability-server.md:1316`
31+
- **Files:** `pai-observability-server/src/observability/manage.sh:8`, `pai-observability-server.md:1316`
3232
- **Fix:** Conditional PATH based on directory existence
3333
- **Status:** Fixed with `[ -d "/opt/homebrew/bin" ]` check
3434

3535
**Auto-Start Feature Parity:**
3636
3. ✅ LaunchAgent plist only (no Linux alternative)
37-
- **File:** `Packs/kai-voice-system/INSTALL.md` Step 9
37+
- **File:** `Packs/pai-voice-system/INSTALL.md` Step 9
3838
- **Fix:** Added systemd user service for Linux
3939
- **Status:** Linux now has full auto-start support
4040

@@ -50,7 +50,7 @@ This document tracks all platform-specific code and dependencies across PAI, pro
5050

5151
**Documentation:**
5252
6. ✅ VERIFY.md misleading "requires modifications" warning
53-
- **File:** `Packs/kai-voice-system/VERIFY.md` lines 11-13
53+
- **File:** `Packs/pai-voice-system/VERIFY.md` lines 11-13
5454
- **Fix:** Updated to reflect Linux is fully supported
5555
- **Status:** Documentation now accurate
5656

@@ -60,7 +60,7 @@ This document tracks all platform-specific code and dependencies across PAI, pro
6060

6161
**Audio Playback (Fixed in PR #285 - Google TTS):**
6262
17. ✅ afplay calls conditionally executed
63-
- **File:** `Packs/kai-voice-system/src/voice/server.ts:286-336`
63+
- **File:** `Packs/pai-voice-system/src/voice/server.ts:286-336`
6464
- **Status:** Runtime platform detection via `process.platform`
6565
- **Implementation:** macOS uses afplay, Linux auto-detects mpg123/mpv/snap
6666

@@ -87,7 +87,7 @@ This document tracks all platform-specific code and dependencies across PAI, pro
8787

8888
**Documentation Inconsistencies:**
8989
7. 🔮 Platform check mentions paplay but code doesn't use it
90-
- **File:** `Packs/kai-voice-system/INSTALL.md` platform check
90+
- **File:** `Packs/pai-voice-system/INSTALL.md` platform check
9191
- **Impact:** Minor - doesn't block functionality
9292
- **Fix:** Either add paplay support or remove from docs
9393
- **Priority:** Low - mpg123/mpv work fine

0 commit comments

Comments
 (0)