{"id":15361948,"url":"https://github.com/tj/pomo","last_synced_at":"2025-04-05T20:06:15.567Z","repository":{"id":694258,"uuid":"338723","full_name":"tj/pomo","owner":"tj","description":"Ruby Pomodoro app for the command-line (time / task management) ","archived":false,"fork":false,"pushed_at":"2016-05-05T14:27:26.000Z","size":326,"stargazers_count":525,"open_issues_count":14,"forks_count":53,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-05-08T18:37:10.672Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"btcsuite/btclog","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tj.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2009-10-15T19:10:52.000Z","updated_at":"2024-04-09T02:51:34.000Z","dependencies_parsed_at":"2022-07-05T09:40:55.769Z","dependency_job_id":null,"html_url":"https://github.com/tj/pomo","commit_stats":null,"previous_names":["visionmedia/pomo"],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tj%2Fpomo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tj%2Fpomo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tj%2Fpomo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tj%2Fpomo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tj","download_url":"https://codeload.github.com/tj/pomo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247393569,"owners_count":20931812,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-01T12:57:33.329Z","updated_at":"2025-04-05T20:06:15.545Z","avatar_url":"https://github.com/tj.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pomo [![Build Status](https://travis-ci.org/visionmedia/pomo.png?branch=master)](https://travis-ci.org/visionmedia/pomo) [![Dependency Status](https://gemnasium.com/visionmedia/pomo.png)](https://gemnasium.com/visionmedia/pomo) [![Code Climate](https://codeclimate.com/github/visionmedia/pomo.png)](https://codeclimate.com/github/visionmedia/pomo)\n\nCommand-line application for the [Pomodoro](http://www.pomodorotechnique.com/)\ntime management technique, with notification and tmux status bar support.\n\n## Description\n\nWith Pomo you can add, remove, list, view, and start timing tasks all via the\ncommand-line with a simple, slick interface. You are reminded of the remaining\ntime on a task via Notification Center, Growl, libnotify, or Quicksilver.\nThese notifications appear half-way, at the 5 minute point, and when the task\nduration has expired. Also, the Pomo timer can be displayed in your tmux\nstatus bar.\n\n## Installation\n\n    $ gem install pomo\n\n## Configuration\n\nPomo uses `~/.pomorc` for configuration options.\n\nTo initialize a default configuration file:\n\n    $ pomo initconfig\n\nSee [Configuration Options](#configuration-options) for more details on all the available options.\n\n## Task Selection API\n\nTaken from `pomo help`:\n\n    pomo provides a unified task selection api which can be used\n    with most of the commands. Commands with [task] or [task ...]\n    in their synopsis accept only single or both single and multiple\n    task selection, respectively.\n\n    Single task selection:\n    n          : selects a single task by index : Ex: pomo remove 1\n    first      : selects the first task         : Ex: pomo remove first\n    last       : selects the last task          : Ex: pomo remove last\n\n    Multiple task selection:\n    [n ]+      : selects several tasks by index : Ex: pomo remove 2 8 1\n    [n..n]+    : selects a range of tasks       : Ex: pomo remove 5..9 11..14\n    [n..-n]+   : selects a range of tasks       : Ex: pomo remove 2..-1\n    [api ]+    : selects several tasks by api   : Ex: pomo remove first last\n    complete   : selects complete tasks         : Ex: pomo remove complete\n    incomplete : selects incomplete tasks       : Ex: pomo remove incomplete\n    all        : selects all tasks              : Ex: pomo remove all\n\n## Examples\n\n  * View global or command specific help:\n\n        $ pomo help\n        $ pomo help add\n        $ pomo help remove\n\n  * Get started by adding a task:\n\n        $ pomo add \"Fix IE6 stying issues\"\n\n    And another:\n\n        $ pomo add \"Destroy IE6\" --description \"because IE6 is terrible\"\n\n  * List your tasks (or use `pomo` which defaults to `pomo list`):\n\n        $ pomo list\n            0. Fix IE6 stying issues                : 25 minutes\n            1. Destroy IE6                          : 25 minutes\n\n  * Start the first incomplete task:\n\n        $ pomo start\n\n    A notification window will display:\n\n![Pomo OS X Notification](http://i.imgur.com/iEfdZ.png)\n\n  * Alternatively, you can start the first incomplete task with a progress bar:\n\n        $ pomo start --progress\n        Started Fix IE6 stying issues, you have 25 minutes :)\n        (=........................) 24 minutes remaining\n\n  * Once you have completed the task, list again (alternatively `pomo ls`) for remaining tasks:\n\n        $ pomo ls\n            1. Destroy IE6                          : 25 minutes\n\n  * Or take a break:\n\n        $ pomo break\n        $ pomo break 10\n        $ pomo break --length 10\n\n  * List all tasks:\n\n        $ pomo ls --all\n          ✓ 0. Fix IE6 stying issues                : 25 minutes\n            1. Destroy IE6                          : 25 minutes\n\n  * List only completed tasks:\n\n        $ pomo ls --complete\n          ✓ 0. Fix IE6 stying issues                : 25 minutes\n\n  * At any time mid-task you may terminate pomo via CTRL + C, at which\n    time you may manually complete the task:\n\n        $ pomo complete first\n        $ pomo complete last\n        $ pomo complete 1\n        $ pomo complete all\n        $ pomo complete incomplete\n        $ pomo complete 5..7\n\n  * The next time you run `pomo start` the first incomplete task\n    will start:\n\n        $ pomo start\n\n    Or choose a specific task:\n\n        $ pomo start first\n        $ pomo start last\n        $ pomo start 5\n\n  * You may also remove tasks:\n\n        $ pomo remove first\n        $ pomo remove last\n        $ pomo remove 2\n        $ pomo remove 1\n        $ pomo remove 6\n        $ pomo rm first\n        $ pomo rm 2..5\n        $ pomo rm 1..-1\n\n  * View task details:\n\n        $ pomo show first\n        $ pomo show last\n        $ pomo show 5\n        $ pomo show 1 2 3\n\n  * Remove all tasks:\n\n        $ pomo remove all\n        $ pomo rm all\n\n  * Or if you prefer, create a directory specific task list. Pomo will\n    auto-detect `./.pomo` in this directory, and utilize its contents.\n\n        $ pomo init\n\n## Configuration Options\n\nThe default configuration for pomo is as follows:\n\n* Notification library is set to Notification Center on OSX 10.8; Growl on OSX\n10.7 or less and Windows; and libnotify on Linux\n* Progress bar is turned off\n* tmux integration is turned off\n\nSettings are easily customizable. Taken from `pomo help initconfig`:\n\n    Examples:\n\n    # Configure with notification center, no progress bar, and tmux integration\n    pomo initconfig --notifier notification_center --no-progress --tmux\n\n    Options:\n      --notifier \u003clib\u003e     Specify notificaiton library: `notification_center`, `libnotify`, `growl`, `quicksilver`\n      --[no-]progress      Run with progress bar\n      --[no-]tmux          Refresh tmux status bar on timer change\n      --[no-]force         force overwrite of existing config file\n\n### Tmux Status Bar Integration\n\nPomo's timer can be displayed in tmux's status bar with the following\nconfiguration set:\n\n    pomo initconfig --tmux\n\nThen add the below to your `~/.tmux.conf`:\n\n    set-option -g status-right '#(cat ~/.pomo_stat)'\n\nThe timer will display with the default color when not active,\ngreen during a Pomodoro, red during the last 5 minutes of a Pomodoro,\nand blue during a break e.g.\n\n![tmux status bar](http://i.imgur.com/uIzM3.png)\n\n## Contributing\n\nWe :heart: pull requests and feedback. Feel free to\n[submit a ticket](https://github.com/visionmedia/pomo/issues) or see\n[CONTRIBUTING](CONTRIBUTING.md)\nfor details on pull requests.\n\n## Copyright\n\nCopyright (c) 2012 TJ Holowaychuk. See\n[LICENSE](LICENSE.md)\nfor details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftj%2Fpomo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftj%2Fpomo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftj%2Fpomo/lists"}