virtue-tracker/README.md

Personal character development CLI tool for tracking virtues and philosophical alignment

# Virtue CLI

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

## 🚀 Quick Start

```bash
# 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

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-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