gemiTask 0.1.2

AI-powered terminal task manager using Google's Gemini for smart task breakdown and management

gemiTask

A powerful AI-powered command-line task management tool that helps you easily manage and track task progress with the help of Google's Gemini AI.

Features

• 🤖 AI-Powered Task Analysis: Break down complex tasks into actionable steps
• 📝 Natural Language Input: Describe tasks in plain English
• 🌲 Subtask Support: Break down large tasks into manageable subtasks
• 🔄 Task Status Tracking: Track task progress (pending, in progress, done)
• ⭐ Priority Management: High, medium, and low priority levels
• 🔗 Task Dependencies: Set dependencies between tasks
• 💾 Local Storage: Auto-save task data in JSON format
• 🎨 Beautiful Terminal Interface: Clear visual display with Rich

Installation

pip install gemiTask

Quick Start

1. Get your Gemini API key

   • Visit Google AI Studio
   • Create a new API key
   • Copy your API key

2. Configure gemiTask

   # Create config directory
   mkdir -p ~/.config/gemiTask
   
   # Create config file
   echo '{
     "gemini_api_key": "your-api-key-here"
   }' > ~/.config/gemiTask/config.json
   

Usage

1. Add a New Task

# Basic usage
gemiTask add "Complete project documentation"

# Add with description and priority
gemiTask add "Complete project documentation" -d "Write README and API docs" -p high

# Priority options: high, medium, low

2. Add Subtasks

# Syntax: gemiTask add-subtask <parent_id> "subtask title" [-d "description"]
gemiTask add-subtask 1 "Write unit tests" -d "Ensure code quality"

3. Update Task Status

# Syntax: gemiTask status <task_id> <status>
gemiTask status 1 in_progress

# Available statuses:
# - pending
# - in_progress
# - done
# - blocked
# - deferred

# Update subtask status
gemiTask status 1.1 done

4. Manage Task Dependencies

# Syntax: gemiTask depend <task_id> <dependency_id>
gemiTask depend 2 1  # Task 2 depends on Task 1

5. View Task List

gemiTask list

# Example output:
# 📋 Task List
# └── 1: Project Documentation (in progress)
#     ├── 1.1: Write README (done)
#     └── 1.2: API Documentation (pending)

6. Get Next Tasks

gemiTask next

# Shows all tasks that can be started
# (no uncompleted dependencies)

Data Storage

Task data is stored in tasks.json in your project directory. This enables:

• Version control of task data with project code
• Easy sharing of task status in teams
• Simple viewing and editing of task data

Use Cases

Personal Project Management

• Track project progress
• Break down large tasks
• Prioritize work

Team Collaboration

• Manage tasks in code repositories
• Share task status via Git
• Track dependencies

Daily Work Management

• To-do list management
• Progress tracking
• Task planning

Development

Install Development Dependencies

pip install -r requirements-dev.txt

Run Tests

pytest

Build Project

python -m build

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Author

• Sanjay Malladi (@sanjaymalladi)
• Email: [e-mail]

License

This project is licensed under the MIT License - see the LICENSE file for details.

Related Links

• GitHub
• PyPI
• Issue Tracker