A simple task management tool with an interactive TUI kanban board and command-line interface.

Note: This is just a hobby project for personal use, I do not aim to keep compatibility between versions or support in any way. Feel free to use, fork, learn from, but don't be surprised if things break things over time. All in the name of learning, experiments, and play.

Data is stored in a SQLite database.

• See CLAUDE.md for schema and additional info

Install using pip:

python3 -m pip install git+https://github.com/mkaz/tasks

Run tasks without any arguments to launch the interactive kanban board:

tasks

The kanban TUI provides full task management including:

• Creating, editing, and deleting tasks
• Moving tasks between states (Todo, Now, Done)
• Setting priorities
• Adding notes and URLs
• Undo functionality

For quick operations, use these commands:

# Add a new task
tasks add "Your task description"

# Mark tasks as complete
tasks do 1 2 3

# Delete tasks
tasks del 1 2 3

# Show all tasks
tasks show

# Show tasks from the last week
tasks show --week

# Show only "Now" tasks
tasks show --now

# Show specific task details
tasks show 5

# Migrate database schema
tasks migrate

Note: Task descriptions must be quoted and use the explicit add command. Running tasks "some text" without the add command will show an error.

Tasks uses a SQLite db to store its data. The program will look in this order for determining what database file to use. Adjust to fit your needs, maybe different databases for differnt projects.

1. If --db DBFILE flag on command-line
2. If tasks.db file in current directory
3. If environment variable TASKS_DB is set
4. Uses your OS data directory

SQLite is a common database format available on all platforms and saves to a single file, this makes it portable and easy to reason about. Additionally, SQLite is extrememly stable, the team has committed to supporting the current API and backwards compatibility to 2050.

Tasks is open source and free to use, modify, and distribute. It is licensed under the MIT License.

An mkaz contrivance.