gemiTask

A CLI task manager with AI-powered task details generation using Google's Gemini AI

Features

• 🧠 AI-Powered Task Breakdown: Automatically generate subtasks, estimates, and priorities
• 📅 Smart Deadline Management: Intelligent deadline suggestions
• 🎯 Priority Scoring: AI-driven priority assessment (1-5 scale)
• 🔗 Dependency Tracking: Identify task dependencies automatically
• 💡 Next Task Suggestions: Get AI recommendations for what to work on next
• 🎨 Beautiful CLI Interface: Rich terminal output with colors and emojis

Installation

npm install -g gemi-task

Prerequisites

• Node.js 14 or higher
• Google Gemini API key (get one from Google AI Studio)

Usage

Set Your API Key

First, set your Gemini API key:

gemiTask set-api-key

Or provide it directly:

gemiTask set-api-key --key YOUR_API_KEY

Adding Tasks

Add a new task with AI-powered breakdown:

gemiTask add "Build a REST API for user management"

With custom priority (1-5, where 1 is highest):

gemiTask add "Deploy to production" --priority 1

With a deadline:

gemiTask add "Finish documentation" --deadline 2023-12-31

Managing Tasks

List all tasks:

gemiTask list

Include completed tasks:

gemiTask list --done

Get detailed breakdown of a task:

gemiTask breakdown 1

Mark a task as done:

gemiTask done 1

Get AI suggestions for what to work on next:

gemiTask suggest

API Usage

You can also use gemiTask programmatically in your Node.js applications:

const gemiTask = require('gemi-task');

// Set API key
gemiTask.config.set('geminiApiKey', 'YOUR_API_KEY');

// Add a task
const task = await gemiTask.addTask('Create user authentication system');
console.log(task);

// List tasks
const tasks = gemiTask.listTasks();
console.log(tasks);

// Mark task as done
const updatedTask = gemiTask.markTaskDone(0); // Task ID (0-based index)
console.log(updatedTask);

// Get AI suggestion for next task
const suggestedTask = gemiTask.suggestNextTask();
console.log(suggestedTask);

Configuration

gemiTask stores configuration in your user's home directory:

• Windows: %USERPROFILE%\.config\gemiTask\config.json
• macOS/Linux: ~/.config/gemiTask/config.json

License

MIT