Taskme - a simple local cli todo

██████ ▄████▄ ▄█████ ██ ▄█▀ ██▄  ▄██ ██████ ██
  ██   ██▄▄██ ▀▀▀▄▄▄ ████   ██ ▀▀ ██ ██▄▄   ██
  ██   ██  ██ █████▀ ██ ▀█▄ ██    ██ ██▄▄▄▄ ▄▄

A fast, beautiful and 100% local task manager for your terminal.

Keep your tasks inside each project, where you already work.

Use Taskme

Unlike cloud task managers, TaskMe stores everything locally.

Every project has its own task list through a simple TASKME.json file.

• No account
• No internet
• No external database
• No configuration

Just open your project and continue working.

Preview

Features

• Zero configuration
• Project-based tasks
• Local JSON database
• Deadlines
• Task history
• Restore completed tasks
• Beautiful terminal output
• Open Source

Installation

npm

npm install -g taskme

bun

bun add -g taskme

Getting Started

Initialize TaskMe inside your project.

cd my-project

task init

This creates:

TASKME.json

Each project keeps its own independent tasks.

Commands

| Command | Description | |----------|-------------| | task list | List pending tasks | | task add | Add a task | | task edit | Edit a task | | task check | Complete a task | | task history | View completed tasks | | task restore | Restore a task | | task remove | Delete a task | | task all | Show all tasks | | task reset | Remove all tasks | | task clear | Clear history |

Example

task list

▶ TASKS

○ a0629  5h  Create Landing Page
○ 1af20  2h  Deploy API
✗ 9cd31  0h  Write README

█████░░░░░ 50%

Complete a task:

task check a0629

✔ Task completed.

Stack

• TypeScript
• Node.js
• Bun
• JSON Storage

Project Structure

src
├── models
├── repository
├── routes
├── service
├── utils
└── index.ts

Roadmap

• [x] Tasks
• [x] History
• [x] Deadlines
• [x] Restore
• [x] Edit
• [ ] Categories
• [ ] Search
• [ ] Interactive TUI
• [ ] Tabs
• [ ] Cloud Sync (optional)

Contributing

Pull requests are welcome.

If you have ideas or found a bug, open an issue.

Author

made while sleepy by Lapolli

GitHub: https://github.com/lapollivinicius