A community-driven port of Daniel Miessler's PAI 2.0 from Claude Code to OpenCode
PAI-OpenCode brings the power of PAI (Personal AI Infrastructure) to the OpenCode platform. This is a systematic, documented migration that validates PAI 2.0's platform independence promise while creating a shareable foundation for the community. We're not just porting code—we're proving that sophisticated AI scaffolding can transcend any single platform.
PAI (Personal AI Infrastructure) is an open-source scaffolding system created by Daniel Miessler for building AI-powered personal assistants. PAI extends AI coding environments with sophisticated capabilities that vanilla installations lack.
Packs - Self-contained bundles of functionality distributed as single markdown files. Each pack contains complete code, configuration, and documentation needed to add capabilities to your AI assistant.
Skills - Domain expertise packages that auto-activate based on natural language triggers. Skills use progressive disclosure to load only what's needed, dramatically reducing token usage.
Agents - Specialized AI personalities (engineer, researcher, architect, designer, pentester) with unique voices and capabilities that can be delegated tasks and work in parallel.
Two Loops Pattern - PAI's architectural philosophy: an Outer Loop (Current → Desired state) combined with an Inner Loop (7-phase execution: Plan → Specify → Clarify → Apply → Validate → Archive → Release).
PAI transforms AI coding assistants from reactive chat interfaces into proactive, context-aware systems with memory, specialized expertise, and systematic workflows. It's the difference between talking to a chatbot and collaborating with a team of specialized experts who understand your context, maintain continuity across sessions, and follow disciplined development practices.
The Platform Reality: Daniel's PAI 2.0 was initially built for Claude Code. While PAI promises platform independence through its pack-and-bundle architecture, the actual migration to OpenCode requires significant adaptation:
- Different Extension Systems: Claude Code uses hooks (JSON configuration), OpenCode uses plugins (TypeScript modules)
- Different Loading Mechanisms: Claude Code lacks native lazy loading (requiring workarounds), OpenCode supports it natively
- Different Session Management: Each platform stores session data differently
- Different API Patterns: Agent delegation, tool execution, and event handling vary between platforms
The Goal: This port validates PAI 2.0's portability claims while documenting every adaptation required. We're creating a reusable blueprint for migrating PAI to any platform—proving the architecture is sound and the methodology works.
The Community Benefit: By documenting this migration thoroughly, we enable others to:
- Migrate PAI to OpenCode following our tested path
- Port PAI to other platforms (Cursor, Windsurf, etc.) using our lessons learned
- Understand the differences between platforms when building portable AI systems
- Contribute improvements back to the ecosystem
Current Version: v0.5.0 - Plugin Infrastructure ✅ COMPLETE
Progress to v1.0 Public Release:
| Milestone | Description | Status |
|---|---|---|
| v0.1 | Foundation (Workspace + Git + Research) | ✅ DONE |
| v0.2 | Vanilla Install (PAI 2.0 packs) | ✅ DONE |
| v0.3 | Skills Translation (OpenCode lazy loading) | ✅ DONE |
| v0.4 | Agent Delegation (Hybrid Task API) | ✅ DONE |
| v0.4.2 | Agent Profiles (Provider switching) | ✅ DONE |
| v0.5 | Plugin Infrastructure (Hook→Plugin translation, 8 core plugin equivalents) | ✅ DONE |
| v0.6 | History System (COMPLETE: OpenCode sessions + PAI knowledge layer) | |
| v0.7 | Converter Tool (PAI→OpenCode translator) | NOT STARTED |
| v0.8 | Integration Testing (End-to-end validation) | NOT STARTED |
| v0.9 | Documentation (Public release prep) | NOT STARTED |
| v1.0 | PUBLIC RELEASE (Community-ready vanilla PAI 2.0) | NOT STARTED |
Recent Achievements:
- v0.3: Skills translation with 94.96% token reduction
- v0.4: 7 core agents migrated, Task wrapper with 19 unit tests
- v0.4.1: Agent UI-Picker visibility fixed
- v0.4.2: Profile system for switching AI providers (Anthropic, OpenAI, Ollama)
- v0.5: Plugin Infrastructure with 2 skeleton plugins, event capture validated
Work in Progress: v0.6 History System is next. This milestone builds on v0.5's plugin infrastructure to implement complete session storage, including OpenCode sessions plus PAI knowledge layer (learnings, research, decisions, ideas, projects).
Deferred to v1.x (Post-Release):
- Voice System (if not part of vanilla PAI 2.0 core)
- Observability Dashboard (community plugins phase)
- Advanced analytics and context pruning beyond 8 core plugins
- Daniel Miessler's additional packs (importable via Converter)
Full Roadmap: See ROADMAP.md for detailed milestone specifications.
This project is a pure vanilla PAI 2.0 port to OpenCode. We include:
✅ All PAI 2.0 Core Components:
- 8 kai-* packs (kai-core-install, kai-hook-system, etc.)
- Skills system with progressive disclosure
- Agent delegation (intern, engineer, architect, designer, pentester)
- COMPLETE History system (OpenCode sessions + PAI knowledge layer: learnings/, research/, decisions/, ideas/, projects/)
- Hooks adapted as OpenCode plugins (6 core plugin equivalents)
- Constitutional framework and Two Loops architecture
- Voice system (if part of vanilla PAI 2.0)
✅ Platform Adaptation Layer:
- Converter tool for importing PAI updates
- Skill format translation for OpenCode lazy loading
- Hook → Plugin adaptation
- Documentation for community use
This is NOT a fork with modifications. We exclude:
❌ Personal Customizations:
- User-specific identity layers (TELOS, Ideology)
- Custom business contexts
- Personal workflow adaptations
- Private tools and extensions
❌ Platform-Specific Experiments:
- Untested feature additions
- Performance optimizations beyond vanilla
- New capabilities not in PAI 2.0
v1.0 = Pure PAI 2.0 on OpenCode. Nothing more, nothing less.
This ensures:
- The port is a faithful reference implementation
- Others can trust it as a starting point
- Platform differences are clearly isolated
- Personal extensions can be built on top (separately)
After v1.0: Personal customizations and extensions live in separate private projects, not in this public repository.
PAI-OpenCode makes 6 key technical decisions documented in our Constitution:
| Decision | Approach | Rationale |
|---|---|---|
| Configuration | Clean Break + Converter | Maintain import capability, not backwards compatibility |
| Agent Delegation | Hybrid (Task API + Subagents) | PAI packs use Task tool, simple tasks use OpenCode native |
| Skills Loading | LazyLoad Translation | OpenCode supports native lazy loading (92.5% token reduction) |
| Hook System | DEFERRED (needs research) | Plugins fundamentally different from hooks—requires investigation |
| History System | OpenCode Sessions (v1.0) | Use native session storage for public port |
| Directory Structure | Clean .opencode/ |
Project-level config, not global, with converter for PAI updates |
Guiding Principle: Import capability over backwards compatibility. We build on OpenCode natively while maintaining the ability to import PAI 2.0 updates via our converter tool.
Full Technical Decisions: See constitution.md Section IX for detailed rationale.
Note: Installation guide coming in v0.2 (next milestone).
- OpenCode installed and configured
- Bun runtime (PAI uses Bun, not Node.js)
- ANTHROPIC_API_KEY environment variable
# Clone the repository
git clone https://github.com/Steffen025/pai-opencode.git
cd pai-opencode
# Install PAI 2.0 packs
bun run install-packs.ts
# Verify installation
bun Tools/PaiArchitecture.ts checkCurrent Status: Foundation complete (workspace + git + research). Installation workflow in development.
We welcome contributions! Here's how you can help:
- Test the Migration: Try installing PAI-OpenCode and report issues
- Document Edge Cases: Found a quirk? Document it for others
- Improve Documentation: Help make our guides clearer
- Share Feedback: Tell us what works and what doesn't
- Report Bugs: File issues with detailed reproduction steps
- Read the Constitution: Our constitution.md defines project principles and scope
- Check Existing Issues: Avoid duplicates by searching first
- Stay Vanilla: v1.0 is pure PAI 2.0—no custom features in this repo
- Document Thoroughly: Explain your reasoning and decisions
- Test Before Submitting: Ensure changes don't break existing functionality
Be respectful, constructive, and collaborative. This is a community project—we're learning together.
This project would not exist without Daniel Miessler's groundbreaking work on PAI (Personal AI Infrastructure). Daniel designed PAI's architecture, created the pack-and-bundle system, and pioneered the Two Loops methodology that makes sophisticated AI scaffolding possible.
Original PAI Repository: https://github.com/danielmiessler/PAI
PAI-OpenCode is a community-driven port that validates Daniel's vision of platform independence. All credit for PAI's core design, philosophy, and innovation belongs to Daniel.
Steffen (@Steffen025) - PAI-OpenCode migration, documentation, and community contribution
This port is based on comprehensive research (48-page synthesis) of PAI 2.0's architecture, pack system, and design principles. See research/SYNTHESIS.md for the complete analysis.
MIT License - Same as the original PAI repository.
This project is open source and free to use, modify, and distribute. See LICENSE for details.
In Daniel's words:
"Do whatever you want with this. Build on it, sell it, modify it. Just don't blame us if something breaks. Attribution appreciated but not required."
- Repository: https://github.com/Steffen025/pai-opencode
- Issues: https://github.com/Steffen025/pai-opencode/issues
- Roadmap: ROADMAP.md
- Constitution: constitution.md
- Research: research/SYNTHESIS.md
v0.5.0 Complete! Plugin Infrastructure established with event capture skeleton:
- 2 working plugins:
pai-session-lifecycle.ts,pai-post-tool-use.ts - Generic
eventhook pattern validated - File-only logging prevents TUI corruption
- Event payload structures documented
Key Learnings from v0.5:
- OpenCode uses generic
eventhook, not specific named hooks - Plugin return type is
Promise<Hooks>, not wrapped structure - Console output corrupts TUI - file-only logging required
- Event filtering happens in-plugin, not via event registration
Next Focus (v0.6 - History System):
- JSONL storage implementation using v0.5 event capture
- Session summary generation on
session.idle - PAI knowledge layer directories (learnings, research, decisions, ideas, projects)
session-searchCLI tool for quick lookup- Complete two-layer architecture (OpenCode sessions + PAI knowledge)
Upcoming Milestones:
- v0.6 - History System (COMPLETE: OpenCode sessions + PAI knowledge layer) -
⚠️ IN PROGRESS (Fixing TUI/Plugin issues) - v0.7 - Converter Tool (PAI→OpenCode translator for upstream updates)
- v0.8 - Integration Testing (End-to-end validation)
- v0.9 - Documentation (Public release prep)
- v1.0 - PUBLIC RELEASE (Community-ready vanilla PAI 2.0)
Follow our progress: Watch this repository or check ROADMAP.md for milestone updates.
PAI-OpenCode - Bringing Personal AI Infrastructure to OpenCode, for the community.