Skip to content

Commit bfcada3

Browse files
docs: Ensure consistency across all packs and documentation
- Updated PAIPackTemplate.md to document BOTH .env and shell profile approaches - Updated kai-hook-system.md, kai-history-system.md, kai-voice-system.md to mention wizard creates .env file - Updated PACKS.md to list all 8 packs (was missing 3 skill packs) - Updated README.md badge from 6 to 8 packs Prevents future inconsistencies between wizard output and pack expectations. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 197f082 commit bfcada3

6 files changed

Lines changed: 52 additions & 6 deletions

File tree

PACKS.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -221,6 +221,8 @@ keywords: [searchable, tags]
221221

222222
Browse all packs: [Packs/](Packs/)
223223

224+
### Foundation Packs
225+
224226
| Pack | Type | Description |
225227
|------|------|-------------|
226228
| [kai-hook-system](Packs/kai-hook-system.md) | Foundation | Event-driven automation framework for hook-based capabilities |
@@ -229,7 +231,15 @@ Browse all packs: [Packs/](Packs/)
229231
| [kai-voice-system](Packs/kai-voice-system.md) | Notifications | Voice output with ElevenLabs TTS and prosody enhancement |
230232
| [kai-observability-server](Packs/kai-observability-server.md) | Observability | Real-time multi-agent monitoring dashboard |
231233

232-
**Installation order:** hooks → history → core-install → voice → observability (optional)
234+
### Skill Packs
235+
236+
| Pack | Type | Description |
237+
|------|------|-------------|
238+
| [kai-art-skill](Packs/kai-art-skill.md) | Skill | Visual content generation with charcoal architectural sketch aesthetic |
239+
| [kai-agents-skill](Packs/kai-agents-skill.md) | Skill | Dynamic agent composition with specialized personalities and voices |
240+
| [kai-prompting-skill](Packs/kai-prompting-skill.md) | Skill | Meta-prompting system for programmatic prompt generation |
241+
242+
**Installation order:** hooks → history → core-install → voice → observability (optional) → skill packs
233243

234244
**Or install the complete [Kai Bundle](Bundles/Kai/)** which handles ordering automatically.
235245

Packs/kai-history-system.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1335,7 +1335,9 @@ Claude Code looks for settings in `~/.claude/settings.json`. Add or merge the fo
13351335

13361336
### Step 5: Set Environment Variables (Optional)
13371337

1338-
Add these to your shell profile (`~/.zshrc`, `~/.bashrc`, etc.):
1338+
**If you used the Kai Bundle wizard:** These are already in `$PAI_DIR/.env` - skip this step.
1339+
1340+
**For manual installation:** Add these to your shell profile (`~/.zshrc`, `~/.bashrc`, etc.):
13391341

13401342
```bash
13411343
# PAI configuration

Packs/kai-hook-system.md

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -384,7 +384,9 @@ echo "Backup complete: $BACKUP_DIR"
384384

385385
#### Step 0.4: Set Required Environment Variables
386386

387-
If not already set, configure these in your shell profile (`~/.zshrc` or `~/.bashrc`):
387+
**If you used the Kai Bundle wizard:** Environment variables are already configured in `$PAI_DIR/.env` - skip to Step 1.
388+
389+
**For manual installation:** Configure these in your shell profile (`~/.zshrc` or `~/.bashrc`):
388390

389391
```bash
390392
# Add to your shell profile
@@ -397,6 +399,15 @@ export PAI_SOURCE_APP="${DA}"
397399
source ~/.zshrc # or ~/.bashrc
398400
```
399401

402+
**Alternative:** Create a `.env` file in your PAI directory:
403+
404+
```bash
405+
# $PAI_DIR/.env
406+
DA="PAI"
407+
PAI_DIR="${HOME}/.config/pai"
408+
TIME_ZONE="America/Los_Angeles"
409+
```
410+
400411
**After completing system analysis, proceed to Step 1.**
401412

402413
---
@@ -1137,7 +1148,9 @@ Claude Code looks for settings in `~/.claude/settings.json`. Add or merge the fo
11371148

11381149
### Step 5: Set Environment Variables (Optional)
11391150

1140-
Add these to your shell profile (`~/.zshrc`, `~/.bashrc`, etc.):
1151+
**If you used the Kai Bundle wizard:** These are already in `$PAI_DIR/.env` - skip this step.
1152+
1153+
**For manual installation:** Add these to your shell profile (`~/.zshrc`, `~/.bashrc`, etc.):
11411154

11421155
```bash
11431156
# PAI configuration

Packs/kai-voice-system.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1501,7 +1501,14 @@ Add voice hooks to `~/.claude/settings.json`:
15011501

15021502
### Step 7: Set Environment Variables
15031503

1504-
Add to your shell profile (`~/.zshrc`, `~/.bashrc`):
1504+
**If you used the Kai Bundle wizard:** Core variables are in `$PAI_DIR/.env`. You only need to add ElevenLabs credentials there:
1505+
1506+
```bash
1507+
# Add to $PAI_DIR/.env
1508+
ELEVENLABS_API_KEY="your-api-key"
1509+
```
1510+
1511+
**For manual installation:** Add to your shell profile (`~/.zshrc`, `~/.bashrc`):
15051512

15061513
```bash
15071514
# Voice configuration

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@
1717

1818
[![Version](https://img.shields.io/badge/version-2.0-blue?style=for-the-badge)](https://github.com/danielmiessler/Personal_AI_Infrastructure/releases)
1919
[![License](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)](LICENSE)
20-
[![Packs](https://img.shields.io/badge/packs-6-purple?style=for-the-badge)](Packs/)
20+
[![Packs](https://img.shields.io/badge/packs-8-purple?style=for-the-badge)](Packs/)
2121
[![Bundles](https://img.shields.io/badge/bundles-1-orange?style=for-the-badge)](Bundles/)
2222

2323
<br/>

Tools/PAIPackTemplate.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -932,11 +932,25 @@ ls -lt $PAI_DIR/history/sessions/2025-12/ | head -5
932932
933933
INSTRUCTIONS FOR AI: Document configuration options.
934934
If no configuration is needed, write "No configuration required."
935+
936+
IMPORTANT: Always document BOTH approaches for environment variables:
937+
1. .env file (for users who used the Kai Bundle wizard)
938+
2. Shell profile exports (for manual installation)
935939
-->
936940

937941
**Environment variables:**
938942

943+
**Option 1: `.env` file** (recommended - created by Kai Bundle wizard):
944+
```bash
945+
# $PAI_DIR/.env
946+
DA="MyAI"
947+
PAI_DIR="$HOME/.config/pai"
948+
TIME_ZONE="America/Los_Angeles"
949+
```
950+
951+
**Option 2: Shell profile** (for manual installation):
939952
```bash
953+
# Add to ~/.zshrc or ~/.bashrc
940954
export PAI_DIR="$HOME/.config/pai"
941955
export TIME_ZONE="America/Los_Angeles"
942956
export DA="MyAI"

0 commit comments

Comments
 (0)