Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Be productive without leaving your keyboard

Try it online at

What is Pomoday?

Pomoday is an easy to use, yet powerful and flexible web-based task management software that you can use with just a keyboard.

It's flexible and doesn't tie with any productivity methodologies, that means, you can customize and use it in anyway you want, try implementing yourself a GTD or Kanban or Pomodoro workflow with it.


  1. Task management (of course)
  2. Keyboard only workflow
  3. Built-in time tracker
  4. Activities log to get an overview on how you spent your day
  5. Dark mode
  6. (A lot coming...)

Usage and Installation

There are two ways to use Pomoday:

Online version

You can use the online version at

Self-hosted version

Please make sure you have node and npm installed on your machine.

To host Pomoday locally or on your own server:

  1. Clone this repository
git clone
  1. Install the dependencies
npm install
  1. Build
npm run dist
  1. Now you can deploy the dist folder anywhere, just like a static web page

It's recommended to deploy it to, because it's easy:

$ cd dist
$ now


To run it locally during development, use:

npm run dev


This repo includes a Dockerfile and a docker-compose.yml to easily run the project in a container. Just run the following two commands to build the container image and start it up:

$ docker-compose build
$ docker-compose up -d

Syncing across devices

To sync the data across devices, you'll need to implement your own backend, please see Backend API Specification for the details.

To use with your own backend, there's a login command in the app, you'll be able to put your backend API URL there.

You can also check the list of 3rd party backend for self-hosted options.

Similar Projects

  • taskbook: This is an awesome task management application that actually works, and works very well for everyone who likes to live in a command line. Pomoday was also heavily inspired by Taskbook, as you can see from the UI and the keyboard-only command interfaces.

Backers and Sponsors

I would like to give a special thanks to all of the advisors and backers who sponsored this project since day-zero.

imhuyqn ledongthuc trungfinity thaod mquy quannt dvkndn


Code Contributors

This project exists thanks to all the people who contribute. [Contribute].

Financial Contributors

Become a financial contributor and help us sustain our community. [Contribute]



Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]


Pomoday is published under BSD 3-Clause license.


A keyboard only task management web app








No releases published

Sponsor this project


No packages published