Tasks Skill

A simple, lightweight task manager with a visual dashboard. Built with pure Node.js - no dependencies required.

What is this?

This is a command-line task manager that helps you track your to-dos. It's designed as a "skill" for Factory AI, but works perfectly as a standalone CLI tool.

Features

• Add tasks with optional priority levels and plans
• Track progress with a visual dashboard
• Organize by priority (high/medium/low)
• Attach plans to tasks for detailed notes
• Zero dependencies - just Node.js

Installation

1. Make sure you have Node.js installed (v14 or higher)
2. Clone this repository:

   git clone https://github.com/joshdayorg/tasks-skill.git
   cd tasks-skill

3. Make the scripts executable (macOS/Linux):

   chmod +x *.js

Usage

Add a Task

./add.js "Your task title"
./add.js "Urgent task" --priority=high
./add.js "Task with plan" --plan="Step 1: Do this, Step 2: Do that"

List All Tasks

./list.js

This shows a dashboard with your progress and all tasks in a table:

╭────────────────────────────────────────────────╮
│  Tasks Dashboard                               │
│  Progress: ████████░░░░░░░░░░░░ 40% 2/5        │
│  Done: 2  In Progress: 1  Pending: 2           │
╰────────────────────────────────────────────────╯

  ID   Status          Priority   Title
  ───────────────────────────────────────────────────────
  3    → in-progress   high       Write documentation
  1    ○ pending       medium     Create video 📋
  2    ○ pending       low        Clean up code
  4    ✓ done          medium     Set up repo
  5    ✓ done          medium     Initial commit

Tasks with a 📋 icon have a plan attached.

Start Working on a Task

./start.js 1

Marks task #1 as "in-progress".

Complete a Task

./done.js 1

Marks task #1 as "done".

Remove a Task

./remove.js 1

Permanently deletes task #1.

View/Edit Task Plans

./plan.js 1              # View plan for task #1
./plan.js 1 "New plan"   # Set or update plan
./plan.js 1 --clear      # Remove plan

Get Next Recommended Task

./next.js

Shows the highest priority pending task you should work on next.

How It Works

All tasks are stored in a tasks.json file in the same directory. Each task has:

• id - Unique identifier (auto-incremented)
• title - Task description
• status - pending, in-progress, or done
• priority - high, medium, or low
• created - Timestamp when created
• completed - Timestamp when marked done (if applicable)
• plan - Optional detailed notes/steps

Using with Factory AI

If you're using this as a Factory AI skill, the scripts are located at:

~/.factory/skills/tasks/

You can ask your AI assistant things like:

• "Add a task: finish the report"
• "Show my tasks"
• "Mark task 3 as done"
• "What's the plan for task 1?"

Tips

• Use high priority for urgent tasks that need immediate attention
• Use plans to break down complex tasks into steps
• Run ./next.js when you're not sure what to work on
• The dashboard shows your overall progress at a glance

License

MIT - Feel free to use and modify as you like!