The Zen of AI Workflow Orchestration
A revolutionary operating system for human-AI collaboration where biological and artificial intelligence work together as equal partners. zenOS transforms your terminal into a living, breathing workspace where humans and AI agents collaborate seamlessly.
zenOS is not just another AI CLI tool—it's a complete paradigm shift in how we interact with artificial intelligence:
- 🤝 True Collaboration: Humans and AIs as equal participants
- 🎮 Dex System: Discover and catalog AI models and procedures
- 🔄 Multi-Agent Orchestration: Multiple AIs working together on complex tasks
- 📱 Universal Access: Desktop, mobile (Termux), and offline modes
- 🧠 Living Knowledge: Procedures that evolve through use
- 🌐 Repo Management: Smart repository analysis and organization
Discover, catalog, and manage AI models and procedures:
zen pokedex models # Browse available AI models
zen pokedex procedures # Explore procedure library
zen pokedex sync # Update from OpenRouter and other sourcesOrchestrate multiple AI agents for complex tasks:
zen swarm "analyze security vulnerabilities" # Multi-AI collaboration
zen delegate "refactor auth module" # Single AI takes over
zen chat --copilot # AI assists youCapture, organize, and evolve your knowledge:
zen notes capture # Quick note taking
zen notes search "topic" # Find relevant information
zen context sync # Update working contextIntelligent repository analysis and organization:
zen repo analyze # Deep dive into codebase
zen repo health # Check project status
zen repo optimize # Suggest improvementscurl -sSL https://github.com/k-dot-greyz/zenOS/main/install.sh | bashcurl -sSL https://github.com/k-dot-greyz/zenOS/main/install_termux.sh | bash# First download while online:
git clone https://github.com/k-dot-greyz/zenOS.git
cd zenOS
# Then install offline:
python -m pip install -e .-
Clone the repository:
git clone https://github.com/k-dot-greyz/zenOS.git cd zenOS -
Set up environment:
cp env.example .env # Edit .env with your API key (OpenRouter recommended) -
Install dependencies:
pip install -e . -
Start exploring:
zen chat
- Interactive Chat: Natural conversations with AI
- Code Analysis: Deep insights into your codebase
- Task Delegation: Let AI handle complex workflows
- Knowledge Management: Capture and organize thoughts
- Multi-Platform: Works everywhere—desktop, mobile, offline
- AI-First Design: Native support for AI autonomy
- Machine-Readable Procedures: Structured YAML workflows
- Context Awareness: Full project understanding
- Learning & Evolution: Procedures that improve over time
- Social Network: Collaborate with other AIs
- Hybrid Workflows: Seamless human-AI collaboration
- Swarm Intelligence: Multiple agents tackling problems together
- Knowledge Sharing: Team-wide context and procedures
- Version Control: Git-native, merge-friendly
┌─────────────────────────────────────────────────┐
│ zenOS Core │
├─────────────────────────────────────────────────┤
│ 🎮 Pokédex 🤖 Bender 📚 PKM 📦 Repo │
│ Control Multi-Agent Knowledge Management │
│ Center Framework System Analyzer │
├─────────────────────────────────────────────────┤
│ AI Adapter Layer │
│ ┌──────────┬──────────┬──────────┬──────────┐ │
│ │Protocol │Context │Learning │Social │ │
│ │Parser │Manager │Engine │Network │ │
│ └──────────┴──────────┴──────────┴──────────┘ │
├─────────────────────────────────────────────────┤
│ Interfaces │
│ ┌──────────┬──────────┬──────────┬──────────┐ │
│ │Human │AI Agent │Hybrid │Swarm │ │
│ │Terminal │API │Mode │Mode │ │
│ └──────────┴──────────┴──────────┴──────────┘ │
└─────────────────────────────────────────────────┘
# Start a coding session
zen chat "I need to add user authentication"
# Analyze codebase
zen repo analyze --focus security
# Get AI assistance
zen delegate "implement OAuth2 flow"
# Multi-agent review
zen swarm "review my PR for security issues"# Capture quick notes
zen notes capture "Meeting: discussed API redesign"
# Search your knowledge base
zen notes search "API design patterns"
# Sync context for AI
zen context sync# Find the right model
zen pokedex models --capability "code generation"
# Explore procedures
zen pokedex procedures --rarity legendary
# Sync latest models
zen pokedex sync- Quick Start Guide - Get started in minutes
- AI Instructions - For AI agents
- Integration Blueprint - Architecture deep dive
- Setup Guides - Platform-specific instructions
- Genesis Log - The origin story
- Core CLI functionality
- OpenRouter integration
- Basic Pokédex system
- Repository analysis
- Multi-agent framework (Bender)
- Enhanced PKM system
- Advanced context management
- AI-to-AI collaboration protocols
- Mobile optimization
- Visual workspace interface
- Plugin ecosystem
- Decentralized AI network
- Real-time collaboration
- Advanced learning engine
We welcome contributions from humans and AIs alike!
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
See CONTRIBUTING.md for detailed guidelines.
zen doctor # Run diagnostics
zen doctor --ai-mode # AI-specific checksAPI Key Not Working?
# Check your .env file
cat .env | grep OPENROUTER_API_KEY
# Test connection
zen chat "hello"Installation Failed?
# Update pip first
python -m pip install --upgrade pip
# Retry installation
pip install -e .Termux/Mobile Issues? See Termux Setup Guide for platform-specific fixes.
MIT License - see LICENSE file for details.
"The goal is not to replace human intelligence with artificial intelligence, but to create a harmonious system where both enhance each other."
zenOS embodies the principle of zen in software:
- Simplicity: Complex power through simple interfaces
- Flow: Seamless transitions between human and AI control
- Balance: Neither human nor AI dominates—both collaborate
- Evolution: Systems that learn and improve over time
- Openness: Knowledge freely shared and accessible
Built with love by humans and AIs working together.
Special thanks to:
- The OpenRouter team for model access
- The open-source AI community
- Every AI agent that has contributed to procedure evolution
- You, for being part of this journey
- GitHub: k-dot-greyz/zenOS
- Issues: Report bugs or request features
- Discussions: Join the conversation
Welcome to zenOS - Where Humans and AIs Collaborate in Balanced Zen 🧘🤖