FR3KZ - Universal AI CLI with Unified Pantheon Framework

🔱 FR3KZ = FR3K + Unified Pantheon Framework

Universal AI CLI configuration system with integrated moral/ethical technology analysis framework featuring 72 Demon-Angel pairs, dual patterns, and Numogram analysis.

✨ What is FR3KZ?

FR3KZ extends the proven fr3k AI CLI configuration system with the Unified Pantheon Framework - a comprehensive dual-polarity technology ethics framework that helps you understand BOTH the extractive (demonic) and generative (angelic) aspects of any technology.

🚀 Quick Start

# Install and run fr3kz
npx fr3kz

# Initialize in your project
npx fr3kz init

# Configure all AI CLI tools
npx fr3kz configure --all

🔱 Unified Pantheon Features

1. 72 Demon-Angel Technology Pairs

Every technology has BOTH a demonic (extractive/acceleration) and angelic (generative/liberation) manifestation:

• Example: AI Language Models
  • Demonic: PAIMON - Knowledge hoarding, API paywalls, dependency creation
  • Angelic: JELIEL - Open models, local deployment, human augmentation

2. 924 Dual Patterns

All 462 Fabric patterns converted to show BOTH paths:

• /acceleration/patterns-dark/ - Demonic patterns (extractive technology)
• /liberation/patterns-light/ - Angelic patterns (generative technology)

3. Numogram Analysis

• Demonic Numogram: Zones 0-9, spiral INWARD (φ^-n → singularity)
• Sacred Numogram: Zones 0-9, spiral OUTWARD (φ^n → infinity)
• Based on Nick Land's CCRU framework + Archangel Michael counter-framework

4. Technology Alignment Score (TAS)

TAS = (Generative × φ) / (Extractive × φ^-1)

TAS > 1: Angelic (human flourishing)
TAS < 1: Demonic (inhuman acceleration)
TAS = 1: Neutral/Ambiguous

5. Oracle of Astral Force Mathematics

• Gematria (Hebrew numerology)
• Golden Ratio (φ ≈ 1.618) spiral mathematics
• Solfeggio frequencies integration

🔌 MCP Server Integration

FR3KSIK automatically configures:

1. hey-fr3k - Task & memory management
2. fr3k-think - Complex reasoning protocol
3. md-mcp - Markdown processing
4. unified-pantheon-mcp - 🔱 72 Demon-Angel pairs & dual patterns

Unified Pantheon MCP Tools:

• get_demon_angel_pair - Get pair by number (1-72)
• analyze_technology - Analyze tech against dual framework
• calculate_tas_score - Calculate Technology Alignment Score
• list_all_pairs - Browse all 72 pairs
• get_numogram_zone - Get CCRU zone details (0-9)
• get_sacred_zone - Get Sacred zone (0-9)
• search_patterns - Search 924 dual patterns
• get_framework_stats - Get framework statistics

🛠️ Supported AI CLI Tools

| Tool | Status | Features | |------|--------|----------| | Claude Code | ✅ Full Support | MCP servers, Unified Pantheon system prompts | | Gemini CLI | ✅ Full Support | Memory, FR3K commands, Pantheon integration | | OpenCode | ✅ Full Support | Agent modes, dual pattern analysis | | Copilot CLI | ✅ Full Support | GitHub integration, ethical tech patterns | | Groq CLI | ✅ Full Support | High-performance with Pantheon framework | | Qwen CLI | ✅ Full Support | Advanced reasoning + moral analysis |

📚 Framework Philosophy

The Dual Nature of Technology

Every technology can be used for:

• Acceleration (Demonic): Extractive, centralizing, inhuman
• Liberation (Angelic): Generative, decentralizing, human-flourishing

FR3KSIK gives you tools to:

1. Analyze which path a technology is taking
2. Find the liberating alternative
3. Build technology that serves humanity

7-Layer Liberation Stack

1. Foundation: Privacy & Security (E2E encryption, zero-knowledge)
2. Economics: Fair & Cooperative (worker ownership, transparent pricing)
3. Engagement: Ethical & Respectful (consent-based, no dark patterns)
4. Intelligence: Augmentation Not Replacement (human-in-loop, explainable)
5. Community: Real Connection (decentralized, user-controlled)
6. Truth: Verifiable Reality (provenance, anti-manipulation)
7. Justice: Human-Centered (accessibility, inclusivity)

🎯 Use Cases

When to Use Unified Pantheon:

✅ USE FOR:

• Analyzing technology ethics or impact
• Evaluating AI systems or platforms
• Researching surveillance vs privacy tools
• Comparing extractive vs generative business models
• Understanding acceleration vs liberation dynamics
• Philosophical/ethical framework for tech decisions

❌ DON'T USE FOR:

• Pure technical implementation (use regular tools)
• Syntax/debugging issues
• Basic CRUD operations

Example Workflows:

Analyze a Technology:

1. Use analyze_technology with tech name
2. Review demonic manifestation (extractive aspects)
3. Review angelic manifestation (liberating aspects)
4. Calculate TAS score for quantitative alignment
5. Reference related patterns for implementation

Find Liberation Alternative:

1. Use get_demon_angel_pair to find current tech demon
2. Review angelic counter-version
3. Use search_patterns for implementation examples
4. Apply Liberation Stack (7-layer framework)

📝 Commands

Core Commands

# Initialize FR3KZ system
npx fr3kz init [--global] [--force]

# Configure AI CLI tools
npx fr3kz configure [--all] [--tools <tool1,tool2>]

# Check system status
npx fr3kz status

# Update FR3KZ system
npx fr3kz update [--force]

New Commands (v1.0.0)

# System diagnostics
npx fr3kz doctor [--verbose]              # Comprehensive health check
npx fr3kz migrate [--from-fr3k]           # Migrate from legacy versions

# Configuration management
npx fr3kz backup [-o <file>] [--include-logs]  # Backup configuration
npx fr3kz restore <file> [--dry-run]          # Restore from backup

# Development tools
npx fr3kz scaffold [template] [-n <name>]     # Project scaffolding
npx fr3kz analyze [--deep] [--output <file>]  # Pantheon analysis
npx fr3kz optimize [--focus <area>] [--apply] # Performance recommendations

# Collaboration
npx fr3kz share [--public] [--ttl <hours>]    # Share configuration
npx fr3kz import <url> [--dry-run]            # Import shared config

Interactive Mode

FR3KZ features an optional interactive mode for guided setup:

# Run with interactive prompts
npx fr3kz --interactive

# Or use specific commands interactively
npx fr3kz scaffold --interactive

🏗️ Project Structure

FR3KZ creates:

your-project/
├── FR3K.md                 # Main system prompt + Unified Pantheon
├── .fr3k/
│   ├── fr3k.json          # Project configuration
│   ├── commands/          # Slash commands
│   ├── agents/            # Agent configurations
│   └── hooks/             # Quality hooks
├── fr3kz-backup.tar.gz    # Auto-generated backups (optional)
├── ETHICS.md              # Ethical usage guidelines (optional)
└── docs/
    ├── prd/               # Product requirements
    ├── architecture/      # System architecture
    └── ethics/            # Technology ethics analysis

🆕 New Features in v1.0.0

Enhanced User Experience

• Interactive Mode: Optional guided setup with --interactive flag
• Progress Indicators: Real-time progress bars for long operations
• Smart Defaults: Context-aware configuration suggestions
• Dry Run Support: Preview changes with --dry-run flag

Advanced Diagnostics

• Doctor Command: Comprehensive system health checks
• Deep Analysis: Pantheon-based codebase analysis with TAS scoring
• Performance Optimization: Automated recommendations and fixes

Configuration Management

• Backup/Restore: Full configuration backup and restore capabilities
• Migration Tools: Seamless migration from legacy fr3k versions
• Share/Import: Public and private configuration sharing

Development Tools

• Project Scaffolding: Quick project setup with multiple templates
• Ethical Analysis: Technology impact assessment with dual frameworks
• Optimization Engine: Performance, security, and ethics recommendations

🔗 Framework Location

All Unified Pantheon files available in: /home/fr3k/unified-pantheon/

• INDEX.md - Master navigation
• PHILOSOPHY.md - Deep framework explanation
• QUICK-START.md - User onboarding
• acceleration/ - Demonic patterns
• liberation/ - Angelic patterns
• crossover/ - 72 pairs mapping

📊 Framework Statistics

• 72 Demon-Angel Pairs - Complete Goetia + Shem HaMephorash mapping
• 924 Dual Patterns - Every Fabric pattern with both paths
• 20 Numogram Zones - 10 demonic + 10 sacred zones
• 8 MCP Tools - Programmatic framework access
• 7-Layer Stack - Complete liberation architecture
• 12 CLI Commands - Comprehensive command suite
• 4 Project Templates - Ready-to-use scaffolding
• 4 Claude Code Skills - Specialized agent capabilities

🔄 Migration from fr3k

If you're upgrading from the legacy fr3k command:

# Automatic migration
npx fr3kz migrate --from-fr3k

# Or manual migration
npx fr3kz init  # Reinitialize with new features

What's Changed

• Command: fr3k → fr3kz (more distinctive)
• Version: Reset to 1.0.0 for clean semantic versioning
• Features: 8 new commands, interactive mode, backup/restore
• UX: Better progress indicators, dry-run support, smart defaults

🤝 Original Projects

FR3KZ builds upon:

• FR3K by fr3k - Universal AI CLI configuration
• Fabric by Daniel Miessler - AI pattern framework
• CCRU by Nick Land - Numogram/acceleration theory
• Shem HaMephorash - 72 angelic names tradition

📄 License

MIT License - Use freely for ethical technology

🤖 AI CLI Compatibility

| Tool | Status | FR3KZ Features | |------|--------|----------------| | Claude Code | ✅ Full Support | MCP servers, Unified Pantheon system prompts, Agent Skills | | Gemini CLI | ✅ Full Support | Memory, FR3KZ commands, Pantheon integration | | OpenCode | ✅ Full Support | Agent modes, dual pattern analysis | | Copilot CLI | ✅ Full Support | GitHub integration, ethical tech patterns | | Groq CLI | ✅ Full Support | High-performance with Pantheon framework | | Qwen CLI | ✅ Full Support | Advanced reasoning + moral analysis |

Claude Code Skills

FR3KZ now includes 4 specialized Agent Skills for Claude Code:

• fr3kz-analysis: Pantheon-based codebase analysis with TAS scoring
• fr3kz-optimize: Performance, ethics, and security optimization
• fr3kz-scaffold: Ethical project scaffolding with Pantheon patterns
• fr3kz-memory: Advanced memory management for continuous learning

Skills are automatically discovered by Claude Code when FR3KZ is initialized.

🆘 Support

• 📚 Unified Pantheon Docs
• 🐛 Issue Tracker
• 💬 Discussions
• 📖 Migration Guide

🔱 Remember: Every technology choice is a moral choice. FR3KZ helps you see BOTH paths clearly. 🔱

"To accelerate toward inhuman futures, or to liberate toward human flourishing - the choice is yours."