virtue-tracker

Virtue CLI

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

🚀 Quick Start

# Install globally
npm install -g virtue-tracker

# Create your first profile
virtue-tracker init

# Start daily tracking
virtue-tracker 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-tracker	Interactive mode with full menu
virtue-tracker init	Create your first virtue profile
virtue-tracker daily	Daily virtue alignment check-in
virtue-tracker quick	Quick 30-second assessment
virtue-tracker analytics	View trends, patterns, and statistics
virtue-tracker monthly	Monthly deep-dive assessment
virtue-tracker insights	AI-powered analysis and recommendations
virtue-tracker export	Export your data as markdown
virtue-tracker drift	Detect philosophical shifts over time

🎯 How It Works

• Profile Creation: Define your personal virtue framework through guided questions
• 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
• Analysis: Mathematical alignment scoring reveals coherence patterns
• 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-tracker 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-tracker --help for detailed command information.

📄 License

MIT