{"id":19689948,"url":"https://github.com/anandman03/task-organizer","last_synced_at":"2025-02-27T08:43:35.405Z","repository":{"id":65514754,"uuid":"306931807","full_name":"anandman03/Task-Organizer","owner":"anandman03","description":"A Tasks, boards, notes \u0026 bookmarks for the command-line habitat","archived":false,"fork":false,"pushed_at":"2020-10-30T12:20:29.000Z","size":407,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-11T01:12:28.137Z","etag":null,"topics":["board","cli","default-board","habitat","javascript","node","nodejs","nodejs-modules","npm","npm-package","npm-publish","optional-arguements","priority","storage","task-manager","timeline"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/taskorganizer","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/anandman03.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-10-24T17:06:04.000Z","updated_at":"2021-09-28T11:22:35.000Z","dependencies_parsed_at":"2023-01-26T21:16:06.334Z","dependency_job_id":null,"html_url":"https://github.com/anandman03/Task-Organizer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anandman03%2FTask-Organizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anandman03%2FTask-Organizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anandman03%2FTask-Organizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anandman03%2FTask-Organizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anandman03","download_url":"https://codeload.github.com/anandman03/Task-Organizer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240996164,"owners_count":19890906,"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":["board","cli","default-board","habitat","javascript","node","nodejs","nodejs-modules","npm","npm-package","npm-publish","optional-arguements","priority","storage","task-manager","timeline"],"created_at":"2024-11-11T19:03:47.045Z","updated_at":"2025-02-27T08:43:35.346Z","avatar_url":"https://github.com/anandman03.png","language":"JavaScript","readme":"\u003ch1 align=\"center\"\u003e\n  Task-Organizer\n\u003c/h1\u003e\n\n\u003ch4 align=\"center\"\u003e\n  A Tasks, boards, notes \u0026 bookmarks for the command-line habitat\n\u003c/h4\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg alt=\"Boards\" width=\"60%\" src=\"media/header-boards.png\"/\u003e\n\u003c/div\u003e\n\n## Description\n\nBy utilizing a simple and minimal usage syntax, that requires a flat learning curve, task-organizer enables you to effectively organize your tasks and notes across multiple boards from within your terminal. All data are written atomically to the storage in order to prevent corruptions, and are never shared with anyone or anything.\n\n## Install\n\n```\nnpm install --global taskorganizer\n\n```\n\n## Highlights\n\n- Organize tasks \u0026 notes to boards\n- Board \u0026 timeline views\n- Priority \u0026 favorite mechanisms\n- Search \u0026 filter items\n- Archive \u0026 restore deleted items\n- Lightweight \u0026 fast\n- Data written atomically to storage\n- Progress overview\n- Simple \u0026 minimal usage syntax\n- Update notifications\n- Data stored in JSON file at `~/.taskListner.json`\n\n## Usage\n\n```\n$ organize --help\n\n  Usage\n    $ organize [\u003coptions\u003e ...]\n    Options\n        none             Display board view\n      --help,     -h     Help log message\n      --version,  -v     Current version\n      --task,     -t     Create task\n      --note,     -n     Create note\n      --remove    -r     Remove items\n      --done,     -d     Mark task done/pending\n      --priority, -p     Update priority of task\n      --board     -b     Change board name\n      --edit,     -e     Edit item description\n      --move,     -m     Move item between boards\n      --find,     -f     Find item/boards\n      --star,     -s     Star/unstar item\n      --copy,     -c     Copy item description to clipboard\n      --unpin,    -u     Remove all completed tasks\n      --timeline, -i     Display timeline view\n      --begin,    -b     Begin/Pause task\n      --list,     -l     List items by attributes\n      --erase,    -e     Clear all the items\n      --mark             Add book mark\n      --unmark           Remove book mark\n      --get              Copy bookmark to clipboard\n      --bookmarks        Display all bookmarks\n\n    Examples\n      $ organize\n      $ organize --help\n      $ organize --version\n      $ organize --task Check commit b:project p:2\n      $ organize --note Complexity of Merge-sort is O(nlogn) b:project\n      $ organize --remove 1\n      $ organize --done 2\n      $ organize --priority 2 p:3\n      $ organize --board c:project n:coding\n      $ organize --edit 2 Some new task description\n      $ organize --move 1 b:college\n      $ organize --find college\n      $ organize --star 3\n      $ organize --copy 1 2 3\n      $ organize --unpin\n      $ organize --timeline\n      $ organize --begin 2\n      $ organize --list pending\n      $ organize --erase\n      $ organize --mark http://abc.com abc\n      $ organize --unmark abc\n      $ organize --get abc\n      $ organize --bookmarks\n```\n\n## Views\n\n### Board View\n\nInvoking task-organizer without any options will display all saved items grouped into their respective boards.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg alt=\"Boards\" width=\"60%\" src=\"media/header-boards.png\"/\u003e\n\u003c/div\u003e\n\n### Timeline View\n\nIn order to display all items in a timeline view, based on their creation date, the `--timeline` option can be used.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg alt=\"Timeline View\" width=\"62%\" src=\"media/timeline.png\"/\u003e\n\u003c/div\u003e\n\n## Flight Manual\n\nThe following is a minor walkthrough containing a set of examples on how to use task-organizer.\n\n### Create Task\n\nTo create a new task use the `--task`/`-t` option with your task's description following right after. There are two optional arguements `b:\u003cboard-name\u003e` and `p:\u003cpriority\u003e`. By default board name is `Default` and priority is 3.\n\n```\n$ organize -t Improve documentation\n$ organize -t Improve documentation b:coding p:2\n\n```\n\n### Create Note\n\nTo create a new note use the `--note`/`-n` option with your note's body following right after. There are two optional arguements `b:\u003cboard-name\u003e` and `p:\u003cpriority\u003e`. By default board name is `Default` and priority is 3.\n\n```\n$ organize -n Mergesort worse-case O(nlogn)\n$ organize -n Mergesort worse-case O(nlogn) b:college p:2\n```\n\n### Remove Item\n\nTo delete an item, use the `--remove`/`-r` options followed by the id of the target items. Duplicate ids are automatically filtered out.\n\n```\n$ organize -r 2\n```\n\n### Done Task\n\nTo mark a task as complete/incomplete, use the `--done`/`-d` option followed by the id of the target task. Note that the option will update to its opposite the `complete` status of the given tasks, thus checking a complete task will render it as pending and a pending task as complete. Duplicate ids are automatically filtered out.\n\n```\n$ organize -d 1\n```\n\n### Set Priority\n\nTo set a priority level for a task while initializing it, include id and the `p:x` syntax in the task's description, where x can be an integer of value `1`, `2` or `3`. Note that all tasks by default are created with a normal priority - `3`.\n\n- `3` - Normal priority\n- `2` - Medium priority\n- `1` - High priority\n\n```\n$ organize -p 1 p:3\n```\n\n### Change Boards\n\nTo change the name of the board, use the `--board/-b` option follwed by `c:x`, where x is the board name to be changed and then `n:y`, where y is the new name of the board.\n\n```\n$ organize -b c:coding n:college\n```\n\n### Edit Item\n\nTo change the description of an item, use the `--edit/-e` option follwed by the id of the target task and new description to be assigned.\n\n```\n$ organize -e 2 New task description\n```\n\n### Move Item\n\nTo move an item to another boards, use the `--move`/`-m` option, followed by the target item id, prefixed by the `b:` symbol, and the name of the destination board. The default board `Default` can be accessed through the `default` keyword.\n\n```\n$ organize -m 1 myboard reviews\n```\n\n### Star Item\n\nTo mark an item as favorite, use the `--star`/`-s` option followed by the id of the target item. The functionality of this option is the same as the one of the above described `--done` option.\n\n```\n$ organize -s 1\n```\n\n### Copy Item Description\n\nTo copy to your system's clipboard the description of one or more items, use the `--copy`/`-y` option followed by the ids of the target items. Note that the option will also include the newline character as a separator to each pair of adjacent copied descriptions, thus resulting in a clear and readable stack of sentences on paste.\n\n```\n$ organize -c 1 2 3\n```\n\n### Delete Marked Done Tasks\n\nTo delete/clear all complete tasks at once across all boards, use the `--unpin`/`-u` option.\n\n```\n$ organize --unpin\n```\n\n### Display Timeline\n\nIn order to display all items in a timeline view, based on their creation date, the `--timeline` option can be used.\n\n```\n$ organize --timeline\n```\n\n### Begin Task\n\nTo mark a task as started/paused, use the `--begin`/`-b` option followed by the id of the target task. The functionality of this option is the same as the one of the above described `--check` option.\n\n```\n$ organize -b 2\n```\n\n### List Items\n\nTo list a group of items where each item complies with a specific set of attributes, use the `--list`/`-l` option followed by the desired attributes. Board names along with item traits can be considered valid listing attributes. For example to list all pending tasks, the following could be used. The available attributes are `pending/in-process/done/notes`.\n\n```\n$ organize -l pending\n```\n\n### Find Items\n\nTo find for task/board, use the `--find`/`-f` option, followed by id of the task or name of the board.\n\n```\n$ organize -l coding\n```\n\n### Erase Items\n\nTo remove all the elements and boards use `--erase`.\n\n```\n$ organize --erase\n```\n\n### Add Bookmark\n\nTo create a new bookmark use the `--mark` option with bookmark's link followed by name of the bookmark.\n\n```\n$ organize --mark https://www.npmjs.com npm\n```\n\n### Remove Bookmark\n\nTo remove a bookmark use the `--unmark` option with bookmark's name.\n\n```\n$ organize --unmark npm\n```\n\n### Copy Bookmark\n\nTo copy a bookmark use the `--get` option with bookmark's name.\n\n```\n$ organize --get npm\n```\n\n### Display Bookmarks\n\nTo display all bookmarks use the `--bookmarks` option. All the names along with links will be displayed.\n\n```\n$ organize --bookmarks\n```\n\n## Related\n\n- [signale](https://github.com/klaussinani/signale) - Highly configurable logging utility\n- [chalk](https://www.npmjs.com/package/chalk) - Terminal string styling done right\n- [clipboardy](https://www.npmjs.com/package/clipboardy) - Access the system clipboard (copy/paste)\n- [boxen](https://www.npmjs.com/package/boxen) - Create boxes in the terminal\n- [meow](https://www.npmjs.com/package/meow) - CLI app helper\n- [carbon](https://carbon.now.sh/) - Create and share beautiful images of your source code.\n\n\n## Creator\n\n- Mansimar Anand [(@anandman03)](https://github.com/anandman03)\n\n## Older version\n\nThe older version of this project can be found [(here)](https://github.com/anandman03/TaskListner)\n\n## License\n\n[MIT](LICENSE)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanandman03%2Ftask-organizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanandman03%2Ftask-organizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanandman03%2Ftask-organizer/lists"}