8000 GitHub - IgorAlexey/taskd: the task queue for the modern era · GitHub
[go: up one dir, main page]

Skip to content
IgorAlexeyPublic

About

the task queue for the modern era

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

575 Commits

Folders and files

Repository files navigation

taskd

a lightweight task queue and tracker in a single binary.
igoralexey.com/taskd

taskd web UI: a project ledger with stuck, claimed, queued and done tasks taskd terminal UI: the queue table with a task and its notes below

taskd is a task queue daemon with atomic leases, dependency tracking, and embedded web and terminal interfaces.

Workers claim tasks under time-limited leases and either mark them done or let them return to the queue. Tasks can wait on other tasks before becoming claimable.

Quickstart

Start the daemon:

taskd serve -addr 127.0.0.1:8080

Add and work tasks from the command line:

export TASKD_URL=http://127.0.0.1:8080 TASKD_PROJECT=myapp
taskd add 'Fix the login redirect'
taskd claim
taskd note 1 'root cause is the cookie path'
taskd done 1

Open http://127.0.0.1:8080 in a browser for the web ledger, or launch the terminal UI:

taskd-tui

Install

curl -fsSLO https://github.com/IgorAlexey/taskd/releases/latest/download/install.sh
sh install.sh

This puts taskd and taskd-tui in ~/.local/bin (TASKD_INSTALL_DIR picks another directory). The tarballs it downloads, for Linux and macOS on amd64 and arm64, are on the releases page.

With a Go toolchain:

go install github.com/IgorAlexey/taskd@latest
go install github.com/IgorAlexey/taskd/cmd/taskd-tui@latest

These land in $(go env GOPATH)/bin, usually ~/go/bin, which has to be on your PATH.

Hosting

Give the daemon a token and every request needs it. taskd and taskd-tui read the same variable; the web UI asks for it once and keeps it in a cookie.

export TASKD_TOKEN=$(openssl rand -hex 16)
taskd serve -addr 127.0.0.1:8080

TASKD_URL=http://127.0.0.1:8080 taskd list

The token travels in a header, so on a network put the daemon behind TLS. A reverse proxy does that; with Caddy:

tasks.example.com {
    reverse_proxy 127.0.0.1:8080
}

About

the task queue for the modern era

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Contributors

Languages

0