Skip to content
Command-line task todo list
Go Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
LICENSE
build.sh
logger.go
main.go
main_test.go
readme.md
show.go
task_fn.go
task_io.go
task_test.go

readme.md

Task

A simple command-line tool for your task list.

Data Storage

Data is stored as plain-text files in TOML format. The files can be edited, searched, or managed as any text files, there is no database or stored state outside of the TOML files.

A top level TASKDIR is used, see configuration section below. The files are stored in project directories using their unique task id and state.

For example, task id 13 in sriracha project is stored at: TASKDIR/sriracha/13.toml

When task 13 is marked complete, renamed to: TASKDIR/sriracha/13.done.toml

The directory structure, file format, and naming allows for using any set of command-line text processing tools, not just task program.

Install

Install using go get github.com/mkaz/task

or Download from Github releases: https://github.com/mkaz/task/releases

Configuration

Task requires a directory to be set to store task files

The task directory can be set:

  • Option 1: Use --task-dir DIR flag on command-line
  • Option 2: Create task.conf in XDG_CONFIG_DIR
  • Option 3: Create $HOME/.task.conf

The config file uses TOML format and requires TaskDir set

Example:

TaskDir='/home/username/Documents/tasks'

Contributions and License

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

All contributions are welcome. Use Github issues to report a bug, or submit a feature request.

An mkaz contrivance.

You can’t perform that action at this time.