KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #codex #claude-code #mcp #rust #deepseek-harness #typescript #ai-agent #cli

cli-task-manager

★ 9 Open GitHub ↗

A beautiful, cross-platform terminal-based task manager with Persian/Jalali date support, rich UI components, and modular architecture. Features arrow key navigation, configurable settings, and works seamlessly on Windows, macOS, and Linux.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🚀 Task CLI Manager v2.0 - Modular Architecture

A beautiful terminal-based task manager with Persian/Jalali date support, rich UI components, and professional modular architecture.

## ✨ Features

### **Core Features**
- 🎨 **Beautiful Terminal UI** - Rich colors, tables, and interactive prompts
- 🎯 **Arrow Key Navigation** - Interactive menus with ↑↓ navigation and Enter selection
- 📅 **Jalali Date Support** - Full Persian calendar integration
- 🌍 **Global Access** - Run from any terminal with `mytasks` command
- 💾 **Configurable Storage** - Choose where to store your tasks
- 🛡️ **Error Handling** - Robust error handling and user-friendly messages
- ⚡ **Easy Setup** - First-time configuration wizard

### **Advanced Features**
- **💫 Dynamic** - Runtime configuration and adaptive UI
- **⚙️ Configurable** - First-time setup wizard and persistent settings
- **📖 Readable** - Clean, documented modular code
- **🔧 Maintainable** - Separation of concerns and extensible design
- **🔄 Flexible** - Plugin-ready architecture and multiple data formats
- **📦 Modular** - Small, focused modules with single responsibilities

## � **Project Structure**

```
task-creator/
├── main.py                    # Main entry point
├── mytasks.bat               # Windows launcher script  
├── requirements.txt          # Dependencies
├── src/                      # Source code modules
│   ├── __init__.py
│   ├── app.py               # Main application controller
│   ├── core/                # Core business logic
│   │   ├── __init__.py
│   │   ├── config.py        # Configuration management
│   │   ├── task.py          # Task data model
│   │   └── data_manager.py  # Data persistence
│   ├── ui/                  # User interface components
│   │   ├── __init__.py
│   │   ├── display.py       # UI display components
│   │   └── input_handler.py # Input handling
│   └── utils/               # Utility modules
│       ├── __init__.py
│       └── navigation.py    # Navigation utilities
└── .venv/                   # Virtual environment
```

## �🛠️ Installation

### Method 1: Automatic Setup (Recommended)
1. Run the setup script:
   ```bash
   setup.bat
   ```
2. Restart your terminal
3. Run `mytasks` from anywhere!

### Method 2: Manual Setup
1. Copy `mytasks.bat` to a directory in your PATH (e.g., `C:\Windows\System32`)
2. Or add the project directory to your PATH environment variable

## 🚀 Usage

### **Starting the Application**
```bash
# Option 1: Global command (after setup)
mytasks

# Option 2: Direct execution
F:/Personal-Projects/task-creator/.venv/Scripts/python.exe main.py

# Option 3: From the directory
cd F:/Personal-Projects/task-creator
python main.py
```

### **First Run Experience**
1. **Welcome Screen** - Shows feature overview
2. **Setup Wizard** - Configure CSV location, date format, defaults
3. **Main Menu** - Beautiful arrow key navigation
4. **Ready to Use** - All features available

### Navigation
- **Arrow Key Navigation**:
  - **↑↓** - Navigate through menu options
  - **Enter** - Select highlighted option
  - **Q** - Quick quit
  - **1-9** - Quick select by number
  - **Ctrl+C** - Exit anytime

### **Menu Structure**
```
🚀 Task CLI Manager
├── 🆕 Add New Task
├── 📋 List All Tasks  
├── ✏️ Edit Task
├── 🗑️ Delete Task
├── 🔍 Filter/Search Tasks
├── 📅 Today's Tasks
├── 📊 Statistics
├── ⚙️ Configuration
├── 📚 Help & Guide
├── 🗑️ Clear All Tasks
├── 💾 Import/Export
└── 👋 Exit Program
```

### Menu Options
- **🆕 Add New Task** - Create tasks with date, duration, name, description, status, priority, tags
- **📋 List All Tasks** - View tasks in beautiful numbered table
- **✏️ Edit Task** - Select and modify existing tasks
- **🗑️ Delete Task** - Select and remove specific tasks  
- **🔍 Filter/Search Tasks** - Interactive filtering by date or search term
- **📅 Today's Tasks** - Quick view of current day's tasks
- **� Statistics** - View task statistics and analytics
- **⚙️ Configuration** - Modify settings and preferences
- **�📚 Help & Guide** - Detailed usage information
- **🗑️ Clear All Tasks** - Delete all tasks with confirmation
- **💾 Import/Export** - Backup and restore functionality
- **👋 Exit Program** - Close the application

## 🎯 **New Features Added**

### **Configuration System**
```python
# First-time setup wizard
config = Config()
if config.is_first_run():
    config.first_time_setup()

# Runtime configuration changes
config.set("csv_file", "/custom/path/tasks.csv")
config.set("date_format", "gregorian")
```

### **Enhanced Task Model**
```python
task = Task(
    date="1403-07-07",
    duration="2h 30min", 
    task="Study Python",
    description="Learn advanced concepts",
    status="completed",
    priority="high",
    tags=["programming", "study"]
)
```

### **Data Management**
```python
# Automatic backups
data_manager.backup_data()

# Import/Export
data_manager.export_data("backup.json", "json")
data_manager.import_data("tasks.csv")

# Advanced filtering
high_priority = data_manager.get_tasks_by_priority("high")
today_tasks = data_manager.get_today_tasks()
```

### **Beautiful UI Components**
```python
ui = UIManager(config)
ui.show_tasks_table(tasks, "My Tasks")
ui.show_task_details(task)
ui.show_statistics(stats)
```

### Example Usage
```
$ mytasks
📋 Your Task Schedule
──────────────────────────────────────────────────────────
📅 Date     ⏱️ Duration   📝 Task   📖 Description   🏷️ Status
──────────────────────────────────────────────────────────
1403-07-07  2h 30min     Study     Python concepts   ✅ completed
1403-07-08  1h           Meeting   Team standup      🔄 pending
```

## 📝 Date & Time Format
- **Jalali calendar format**: `YYYY-MM-DD` (e.g., `1403-07-15`)
- **Duration format**: `2h`, `30min`, `1h 30min`
- **Flexible input**: Supports various duration formats

## 📁 File Storage
- **Configurable location**: Choose your preferred storage path during setup
- **Default location**: `~/.task-cli/tasks.csv`
- **Automatic backups**: Backup system for data safety
- **Import/Export**: Support for CSV and JSON formats

## 🔧 **Technical Improvements**

### **Architecture Benefits**
- **Single Responsibility**: Each module handles one concern
- **Dependency Injection**: Configuration passed to components
- **Loose Coupling**: Modules interact through well-defined interfaces
- **High Cohesion**: Related functionality grouped together
- **Testable**: Each module can be tested independently

### **Code Quality**
- **Type Safety**: Full type hints throughout
- **Error Handling**: Graceful error recovery
- **Documentation**: Comprehensive docstrings
- **Consistent Style**: Following PEP 8 guidelines
- **Maintainable**: Easy to understand and modify

### **Performance**
- **Lazy Loading**: Modules loaded only when needed
- **Efficient Data Access**: Optimized CSV operations
- **Memory Management**: Proper resource cleanup
- **Responsive UI**: Non-blocking operations

### **📦 Small, Focused Modules**
- **config.py** (147 lines): Configuration management
- **task.py** (189 lines): Task data model
- **data_manager.py** (234 lines): Data persistence
- **display.py** (261 lines): UI components
- **input_handler.py** (253 lines): Input handling
- **navigation.py** (203 lines): Navigation utilities
- **app.py** (287 lines): Main controller

## 🔧 Dependencies
- Python 3.12+
- `rich` - For beautiful terminal UI
- `jdatetime` - For Jalali date support

## 📱 Screenshots

### Main Menu
```
┌──────────────────────────────────── Welcome ────────────────────────────────────┐
│                          🚀 Task CLI Manager                                    │
│                          Manage your tasks beautifully                          │
└─────────────────────────────────────────────────────────────────────────────────┘

Choose an option [add/list/clear/help/exit] (list):
```

### Adding a Task
```
─────────────────────── 📝 Add New Task ────────────────────────

📅 Enter date (Jalali format YYYY-MM-DD) [1403-07-07]:
⏰ Enter time (HH:MM format) [09:00]: 15:30
📝 Enter task name: Study
📖 Enter task description: Heat Transfer homework
```

## � **Ready for Production!**

Your Task CLI Manager is now:
- ✅ **Dynamic** - Adapts to user preferences
- ✅ **Configurable** - First-time setup and runtime config
- ✅ **Readable** - Clean, documented code
- ✅ **Maintainable** - Modular architecture
- ✅ **Flexible** - Extensible design
- ✅ **Modular** - Small, focused files

The application provides a professional-grade task management experience with enterprise-level code quality! 🚀

## 🤝 Contributing
Feel free to fork this project and submit pull requests for improvements!

## 📄 License
This project is open source and available under the MIT License.

cli-task-manager

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README