Virtue CLI

A sophisticated personal character development tool for tracking virtues and philosophical alignment.

🚀 Quick Start

# Install globally
npm install -g virtue-cli

# Create your first profile
virtue-cli init

# Start daily tracking
virtue-cli daily

✨ Features

• 🧭 Custom Virtue Frameworks - Create personalized virtue systems or use philosophical templates
• 📝 Daily Check-ins - Track alignment with want/pull scoring system
• ⚡ Quick Check-ins - 30-second assessments for busy days
• 📊 Analytics Dashboard - Visualize trends, streaks, and coherence patterns
• 🤖 AI-Powered Insights - Get personalized recommendations (when available)
• 🔍 Monthly Deep-Dives - Comprehensive assessments with growth planning
• 📤 Data Export - Generate markdown reports for external tools
• 🎨 Beautiful CLI - Animated interface with ASCII art and progress indicators
• 🔒 Privacy-First - All data stored locally in SQLite, never leaves your machine

📋 Commands

| Command | Description | |---------|-------------| | virtue-cli | Interactive mode with full menu | | virtue-cli init | Create your first virtue profile | | virtue-cli daily | Daily virtue alignment check-in | | virtue-cli quick | Quick 30-second assessment | | virtue-cli analytics | View trends, patterns, and statistics | | virtue-cli monthly | Monthly deep-dive assessment | | virtue-cli insights | AI-powered analysis and recommendations | | virtue-cli export | Export your data as markdown | | virtue-cli drift | Detect philosophical shifts over time |

🎯 How It Works

1. Profile Creation: Define your personal virtue framework through guided questions
2. Daily Tracking: Score virtues on two dimensions:
   • Want (💭): How much you aspire to embody the virtue
   • Pull (🎯): How naturally you're drawn to the behaviors
3. Analysis: Mathematical alignment scoring reveals coherence patterns
4. Growth: Receive insights and interventions for character development

🏛️ Philosophical Frameworks

Choose from established virtue traditions or create your own:

• Stoic Philosophy - Wisdom, Justice, Courage, Temperance
• Aristotelian Ethics - Practical wisdom and character excellence
• Buddhist Path - The Noble Eightfold Path
• Christian Virtues - Cardinal and theological virtues
• Confucian Values - Traditional Chinese virtues
• Modern Integration - Contemporary synthesis

🔧 Configuration

The application works standalone with no setup required. When run in enhanced environments, additional AI features become available automatically.

📈 Data & Privacy

• Local Storage: All data stored in SQLite database on your machine
• No Cloud Sync: Your personal development data never leaves your device
• Export Control: Generate reports when and how you want them
• No Analytics: No usage tracking or telemetry

💡 Use Cases

• Personal Development: Track character growth over time
• Philosophical Practice: Apply virtue ethics to daily life
• Habit Formation: Build virtue-aligned behaviors
• Self-Reflection: Structured introspection and assessment
• Goal Setting: Align actions with deeper values

🎨 Example Session

$ virtue-cli daily

╭─ Daily Virtue Check-in ─╮
│                         │
│  How aligned are you    │
│  with Courage today?    │
│                         │
│  Want: ████████░ 8/10   │
│  Pull: ██████░░ 6/10    │
│                         │
│  Coherence: 94% 🟢      │
╰─────────────────────────╯

🏗️ Requirements

• Node.js 18+
• npm 8+
• OS: Works on macOS, Linux, Windows

🆘 Support

Run virtue-cli --help for detailed command information.

📄 License

MIT