# Rogue Codex
**An open-source knowledge base and AI-powered fitness system built with Obsidian**
[](https://opensource.org/licenses/MIT)
[](https://github.com/jaysig/Rogue-Codex/discussions)
---
## 🎯 What is Rogue Codex?
Rogue Codex is a comprehensive knowledge management system featuring:
- **📚 Curated Knowledge Base** - Organized lessons learned, tools evaluations, and industry insights
- **🏋️ AI Fitness System** - Conversational fitness tracking with intelligent coaching
- **🌟 Company Spotlight** - Featured companies making AI news across entertainment, media, and tech
- **🔧 Template-Driven Workflows** - Reusable templates for consistent knowledge capture
Built with [Obsidian](https://obsidian.md) for powerful linking, search, and visualization capabilities.
---
## 🚀 Quick Start
### Prerequisites
- A computer (Windows, Mac, or Linux)
- [Obsidian](https://obsidian.md) (free)
- 30 minutes for setup
### Installation
1. **Clone this repository:**
```bash
git clone https://github.com/jaysig/Rogue-Codex.git
cd Rogue-Codex
```
2. **Open in Obsidian:**
- Launch Obsidian
- Click "Open folder as vault"
- Select the `Rogue-Codex` folder
3. **Start exploring!**
- Check out `Start Here.md` for an overview
- Browse the `Fitness Guide/` for AI-powered fitness tracking
- Explore `Lessons Learned/` for knowledge templates
**Need detailed setup help?** See our comprehensive [**TECH_SETUP.md**](TECH_SETUP.md) guide.
---
## 🏗️ System Architecture
### Core Components
```
Rogue Codex/
├── 📋 Lessons Learned/ # Structured knowledge templates
├── 🏋️ Fitness Guide/ # AI-powered fitness system
├── 🌟 Company Spotlight/ # Featured companies making AI news
├── 🔧 Tools/ # Software evaluations & rankings
├── 📊 AI Regulation/ # Global AI law tracking
├── ⚠️ AI Risk/ # AI threats and vulnerabilities
├── 💼 Coding Setup/ # Developer environment guides
└── 🎓 100 TUF/ # Personal development journey
```
### Fitness Guide Features
The AI fitness system offers:
- **Natural Language Tracking** - "Just did squats 315x5" → automatic PR detection
- **ASCII Progress Graphs** - Visual progress tracking across all metrics
- **Intelligent Coaching** - Routes to specialized fitness agents
- **Nutrition Planning** - Complete meal plans with grocery lists
- **Program Customization** - Adapts to equipment, goals, and experience
---
## 🎮 Usage Examples
### Basic Knowledge Management
```markdown
# Create a new lesson learned
1. Go to Lessons Learned/
2. Use the provided templates
3. Link related concepts with [[brackets]]
4. Watch the knowledge graph grow!
```
### AI Fitness Tracking
```markdown
# Natural language logging
"Just finished upper body - bench 225x8, rows 185x12"
# The system automatically:
- Detects if 225x8 is a new PR
- Updates your strength tracking
- Suggests next workout based on fatigue
- Offers nutrition recommendations
```
### Company Research
```markdown
# Structured company profiles
- Organized by industry (AI, Film, Gaming, etc.)
- Traditional vs AI-Native categorization
- Standardized research templates
- Built-in Perplexity search queries
```
---
## 🤖 AI Integration
### Fitness System
Powered by Claude Code for:
- Conversational workout logging
- Intelligent program generation
- Progress analysis and recommendations
- Specialized coaching (powerlifting, endurance, etc.)
### Setup AI Features
1. Install [Claude Code](https://www.anthropic.com/claude-code)
2. Follow the fitness guide setup in `Fitness Guide/User_Interaction_Guide.md`
3. Start logging: "I want to get stronger" or "Just did a workout"
**Note:** All templates work manually in Obsidian even without AI setup.
---
## 📖 Documentation
- **[TECH_SETUP.md](TECH_SETUP.md)** - Complete installation guide for all platforms
- **[LICENSE.md](LICENSE.md)** - MIT license and usage terms
- **Start Here.md** - Overview and navigation guide
- **Section READMEs** - Each major section has detailed documentation
### Key Sections
- **Fitness Guide/** - Complete AI fitness system documentation
- **Lessons Learned/** - Knowledge capture templates and examples
- **Tools/** - Software evaluation framework and rankings
- **Company Spotlight/** - Featured companies and research templates
---
## 🛠️ Development
### Contributing
We welcome contributions! This project embodies open knowledge sharing:
1. **Fork the repository**
2. **Make your improvements**
3. **Share back with the community** (optional but appreciated)
4. **Open a discussion** to share your use case
### Local Development
```bash
# Clone the repo
git clone https://github.com/jaysig/Rogue-Codex.git
# Open in Obsidian
# No build process needed - it's all markdown!
# For AI features, install Claude Code
# See TECH_SETUP.md for detailed instructions
```
---
## 🌟 Use Cases
### Personal Knowledge Management
- **Students** - Organize research and learning notes
- **Professionals** - Track industry insights and lessons learned
- **Researchers** - Maintain structured knowledge across domains
### Fitness & Health
- **Athletes** - Professional-grade training tracking
- **Beginners** - Guided fitness journey with AI coaching
- **Coaches** - Client management and program templates
### Business Intelligence
- **Investors** - Company research and industry analysis
- **Entrepreneurs** - Market research and competitive intelligence
- **Analysts** - Structured data collection and insights
---
## 🎁 What's Included
### Templates & Frameworks
- Lesson learned capture templates
- Tool evaluation criteria
- Company research templates
- Fitness program library (50+ programs)
- Personal development tracking
### Complete Examples
- Full user fitness journeys (beginner strength, marathon training)
- Realistic progress tracking demonstrations
- Template usage examples across all sections
### Reference Materials
- Exercise library with form cues
- Nutrition planning templates
- Recovery protocols
- ASCII graph examples for progress visualization
---
## 📊 Project Stats
- **50+ Fitness Programs** across all disciplines
- **100+ Company Profiles** in development
- **Template-driven** approach for consistency
- **Cross-platform** compatibility (Windows, Mac, Linux)
- **Open Source** MIT license
---
## 🤝 Community
- **GitHub Discussions:** [Share your use cases and ask questions](https://github.com/jaysig/Rogue-Codex/discussions)
- **Issues:** [Report bugs or request features](https://github.com/jaysig/Rogue-Codex/issues)
- **License:** MIT - Use freely, commercial or personal
### Show Your Support
- ⭐ **Star this repository** if you find it useful
- 🍴 **Fork and adapt** for your own knowledge system
- 💬 **Share your use case** in GitHub Discussions
- 🔄 **Contribute improvements** back to the community
---
## 📄 License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.
**TL;DR:** Use it freely, modify it extensively, build commercial products with it. Just keep the license notice and optionally give us a shout-out!
---
## 🚀 Getting Started
Ready to build your own knowledge system?
1. [**Download the setup guide**](TECH_SETUP.md) - Complete installation instructions
2. [**Start with fitness tracking**](Fitness%20Guide/Fitness%20Guide%20Master.md) - Try the AI-powered features
3. [**Explore the templates**](Lessons%20Learned/Lessons%20Overview.md) - Adapt for your needs
4. [**Join the discussion**](https://github.com/jaysig/Rogue-Codex/discussions) - Share your experience
---
*Built with ❤️ for the open knowledge community*