[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-10344":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":25,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":32,"readmeContent":33,"aiSummary":34,"trendingCount":16,"starSnapshotCount":16,"syncStatus":17,"lastSyncTime":35,"discoverSource":36},10344,"taskbook","klaudiosinani\u002Ftaskbook","klaudiosinani","Tasks, boards & notes for the command-line habitat","https:\u002F\u002Fklaudiosinani.com\u002Ftaskbook",null,"JavaScript",9322,397,123,77,0,2,6,14,8,38.8,"MIT License",false,"master",true,[27,28,29,30,31],"board","cli","note","task","todo","2026-06-12 02:02:20","\u003Ch1 align=\"center\">\n  Taskbook\n\u003C\u002Fh1>\n\n\u003Ch4 align=\"center\">\n  Tasks, boards & notes for the command-line habitat\n\u003C\u002Fh4>\n\n\u003Cdiv align=\"center\">\n  \u003Cimg alt=\"Boards\" width=\"70%\" src=\"media\u002Fheader-boards.png\"\u002F>\n\u003C\u002Fdiv>\n\n\u003Cdiv align=\"center\">\n  \u003Cbr>\n  \u003Csup>\u003Cb>Sponsored by:\u003C\u002Fb>\u003C\u002Fsup>\n  \u003Cbr>\n  \u003Ca href=\"https:\u002F\u002Fbetterstack.com\">\n    \u003Cdiv>\n      \u003Cimg src=\"https:\u002F\u002Fgithub.com\u002FSeldaek\u002Fmonolog\u002Fassets\u002F183678\u002F7de58ce0-2fa2-45c0-b3e8-e60cebb3c4cf\" width=\"200\" alt=\"Better Stack\">\n    \u003C\u002Fdiv>\n    \u003Csup>\n      Spot, Resolve, and Prevent Downtime.\n    \u003C\u002Fsup>\n  \u003C\u002Fa>\n\u003C\u002Fdiv>\n\n## Description\n\nBy utilizing a simple and minimal usage syntax, that requires a flat learning curve, taskbook enables you to effectively manage 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. Deleted items are automatically archived and can be inspected or restored at any moment.\n\nRead this document in:\n[Albanian - Shqip](https:\u002F\u002Fgithub.com\u002Fklaudiosinani\u002Ftaskbook\u002Fblob\u002Fmaster\u002Fdocs\u002Freadme.AL.md), [Polski](https:\u002F\u002Fgithub.com\u002Fklaudiosinani\u002Ftaskbook\u002Fblob\u002Fmaster\u002Fdocs\u002Freadme.PL.md), [简体中文](https:\u002F\u002Fgithub.com\u002Fklaudiosinani\u002Ftaskbook\u002Fblob\u002Fmaster\u002Fdocs\u002Freadme.ZH.md), [Русский](https:\u002F\u002Fgithub.com\u002Fklaudiosinani\u002Ftaskbook\u002Fblob\u002Fmaster\u002Fdocs\u002Freadme.RU.md), [Français](https:\u002F\u002Fgithub.com\u002Fklaudiosinani\u002Ftaskbook\u002Fblob\u002Fmaster\u002Fdocs\u002Freadme.FR.md), [Deutsch](https:\u002F\u002Fgithub.com\u002Fklaudiosinani\u002Ftaskbook\u002Fblob\u002Fmaster\u002Fdocs\u002Freadme.GER.md), [Portuguese](https:\u002F\u002Fgithub.com\u002Fklaudiosinani\u002Ftaskbook\u002Fblob\u002Fmaster\u002Fdocs\u002Freadme.PT-BR.md), [日本語](https:\u002F\u002Fgithub.com\u002Fklaudiosinani\u002Ftaskbook\u002Fblob\u002Fmaster\u002Fdocs\u002Freadme.JP.md), [한국어](https:\u002F\u002Fgithub.com\u002Fklaudiosinani\u002Ftaskbook\u002Fblob\u002Fmaster\u002Fdocs\u002Freadme.KR.md), [Spanish](https:\u002F\u002Fgithub.com\u002Fklaudiosinani\u002Ftaskbook\u002Fblob\u002Fmaster\u002Fdocs\u002Freadme.ES.md), [Bulgarian](https:\u002F\u002Fgithub.com\u002Fklaudiosinani\u002Ftaskbook\u002Fblob\u002Fmaster\u002Fdocs\u002Freadme.BG.md).\n\nYou can now support the development process through [GitHub Sponsors](https:\u002F\u002Fgithub.com\u002Fsponsors\u002Fklaudiosinani).\n\nVisit the [contributing guidelines](https:\u002F\u002Fgithub.com\u002Fklaudiosinani\u002Ftaskbook\u002Fblob\u002Fmaster\u002Fcontributing.md#translating-documentation) to learn more on how to translate this document into more languages.\n\n## Highlights\n\n- Organize tasks & notes to boards\n- Board & timeline views\n- Priority & favorite mechanisms\n- Search & filter items\n- Archive & restore deleted items\n- Lightweight & fast\n- Data written atomically to storage\n- Custom storage location\n- Progress overview\n- Simple & minimal usage syntax\n- Update notifications\n- Configurable through `~\u002F.taskbook.json`\n- Data stored in JSON file at `~\u002F.taskbook\u002Fstorage`\n- Data location can be overwritten at runtime\n\nView highlights in a [taskbook board](https:\u002F\u002Fraw.githubusercontent.com\u002Fklaudiosinani\u002Ftaskbook\u002Fmaster\u002Fmedia\u002Fhighlights.png).\n\n## Contents\n\n- [Description](#description)\n- [Highlights](#highlights)\n- [Install](#install)\n- [Usage](#usage)\n- [Views](#views)\n- [Configuration](#configuration)\n- [Flight Manual](#flight-manual)\n- [Development](#development)\n- [Related](#related)\n- [Team](#team)\n- [Sponsors](#sponsors)\n- [License](#license)\n\n## Install\n\n### Yarn\n\n```bash\nyarn global add taskbook\n```\n\n### NPM\n\n```bash\nnpm install --global taskbook\n```\n\n### Snapcraft\n\n```bash\nsnap install taskbook\nsnap alias taskbook tb # set alias\n```\n\n**Note:** Due to the snap's strictly confined nature, both the storage & configuration files will be saved under the [`$SNAP_USER_DATA`](https:\u002F\u002Fdocs.snapcraft.io\u002Freference\u002Fenv) environment variable instead of the generic `$HOME` one.\n\n## Usage\n\n```\n$ tb --help\n\n  Usage\n    $ tb [\u003Coptions> ...]\n\n    Options\n        none             Display board view\n      --archive, -a      Display archived items\n      --begin, -b        Start\u002Fpause task\n      --check, -c        Check\u002Funcheck task\n      --clear            Delete all checked items\n      --copy, -y         Copy item description\n      --delete, -d       Delete item\n      --edit, -e         Edit item description\n      --find, -f         Search for items\n      --help, -h         Display help message\n      --list, -l         List items by attributes\n      --move, -m         Move item between boards\n      --note, -n         Create note\n      --priority, -p     Update priority of task\n      --restore, -r      Restore items from archive\n      --star, -s         Star\u002Funstar item\n      --taskbook-dir     Define a custom taskbook directory\n      --task, -t         Create task\n      --timeline, -i     Display timeline view\n      --version, -v      Display installed version\n\n    Examples\n      $ tb\n      $ tb --archive\n      $ tb --begin 2 3\n      $ tb --check 1 2\n      $ tb --clear\n      $ tb --copy 1 2 3\n      $ tb --delete 4\n      $ tb --edit @3 Merge PR #42\n      $ tb --find documentation\n      $ tb --list pending coding\n      $ tb --move @1 cooking\n      $ tb --note @coding Mergesort worse-case O(nlogn)\n      $ tb --priority @3 2\n      $ tb --restore 4\n      $ tb --star 2\n      $ tb --taskbook-dir .custom-taskbook-dir\n      $ tb --task @coding @reviews Review PR #42\n      $ tb --task @coding Improve documentation\n      $ tb --task Make some buttercream\n      $ tb --timeline\n```\n\n## Views\n\n### Board View\n\nInvoking taskbook without any options will display all saved items grouped into their respective boards.\n\n\u003Cdiv align=\"center\">\n  \u003Cimg alt=\"Boards\" width=\"60%\" src=\"media\u002Fheader-boards.png\"\u002F>\n\u003C\u002Fdiv>\n\n### Timeline View\n\nIn order to display all items in a timeline view, based on their creation date, the `--timeline`\u002F`-i` option can be used.\n\n\u003Cdiv align=\"center\">\n  \u003Cimg alt=\"Timeline View\" width=\"62%\" src=\"media\u002Ftimeline.png\"\u002F>\n\u003C\u002Fdiv>\n\n## Configuration\n\nTo configure taskbook navigate to the `~\u002F.taskbook.json` file and modify any of the options to match your own preference. To reset back to the default values, simply delete the config file from your home directory.\n\nThe following illustrates all the available options with their respective default values.\n\n```json\n{\n  \"taskbookDirectory\": \"~\",\n  \"displayCompleteTasks\": true,\n  \"displayProgressOverview\": true\n}\n```\n\n### In Detail\n\n##### `taskbookDirectory`\n\n- Type: `String`\n- Default: `~`\n\nFilesystem path where the storage will be initialized, i.e: `\u002Fhome\u002Fusername\u002Fthe-cloud` or `~\u002Fthe-cloud`\n\nIf left undefined the home directory `~` will be used and taskbook will be set-up under `~\u002F.taskbook\u002F`.\n\n##### `displayCompleteTasks`\n\n- Type: `Boolean`\n- Default: `true`\n\nDisplay tasks that are marked as complete.\n\n##### `displayProgressOverview`\n\n- Type: `Boolean`\n- Default: `true`\n\nDisplay progress overview below the timeline and board views.\n\n## Flight Manual\n\nThe following is a minor walkthrough containing a set of examples on how to use taskbook.\nIn case you spotted an error or think that an example is not to clear enough and should be further improved, please feel free to open an [issue](https:\u002F\u002Fgithub.com\u002Fklaudiosinani\u002Ftaskbook\u002Fissues\u002Fnew\u002Fchoose) or [pull request](https:\u002F\u002Fgithub.com\u002Fklaudiosinani\u002Ftaskbook\u002Fcompare).\n\n### Create Task\n\nTo create a new task use the `--task`\u002F`-t` option with your task's description following right after.\n\n```\n$ tb -t Improve documentation\n```\n\n### Create Note\n\nTo create a new note use the `--note`\u002F`-n` option with your note's body following right after.\n\n```\n$ tb -n Mergesort worse-case O(nlogn)\n```\n\n### Create Board\n\nBoards are automatically initialized when creating a new task or note. To create one or more boards, include their names, prefixed by the `@` symbol, in the description of the about-to-be created item. As a result the newly created item will belong to all of the given boards. By default, items that do not contain any board names in their description are automatically added to the general purpose; `My Board`.\n\n```\n$ tb -t @coding @docs Update contributing guidelines\n```\n\n### Check Task\n\nTo mark a task as complete\u002Fincomplete, use the `--check`\u002F`-c` option followed by the ids of the target tasks. 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$ tb -c 1 3\n```\n\n### Begin Task\n\nTo mark a task as started\u002Fpaused, use the `--begin`\u002F`-b` option followed by the ids of the target tasks. The functionality of this option is the same as the one of the above described `--check` option.\n\n```\n$ tb -b 2 3\n```\n\n### Star Item\n\nTo mark one or more items as favorite, use the `--star`\u002F`-s` option followed by the ids of the target items. The functionality of this option is the same as the one of the above described `--check` option.\n\n```\n$ tb -s 1 2 3\n```\n\n### Copy Item Description\n\nTo copy to your system's clipboard the description of one or more items, use the `--copy`\u002F`-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$ tb -y 1 2 3\n```\n\n### Display Boards\n\nInvoking taskbook without any options will display all of saved items grouped into their respective boards.\n\n```\n$ tb\n```\n\n### Display Timeline\n\nIn order to display all items in a timeline view, based on their creation date, the `--timeline`\u002F`-i` option can be used.\n\n```\n$ tb -i\n```\n\n### Set Priority\n\nTo set a priority level for a task while initializing it, include 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 - `1`.\n\n- `1` - Normal priority\n- `2` - Medium priority\n- `3` - High priority\n\n```\n$ tb -t @coding Fix issue `#42` p:3\n```\n\nTo update the priority level of a specific task after its creation, use the `--priority`\u002F`-p` option along with the id the target task, prefixed by the `@` symbol, and an integer of value `1`, `2` or `3`. Note that the order in which the target id and priority level are placed is not significant.\n\n```\n$ tb -p @1 2\n```\n\n### Move Item\n\nTo move an item to one or more boards, use the `--move`\u002F`-m` option, followed by the target item id, prefixed by the `@` symbol, and the name of the destination boards. The default `My board` can be accessed through the `myboard` keyword. The order in which the target id and board names are placed is not significant.\n\n```\n$ tb -m @1 myboard reviews\n```\n\n### Delete Item\n\nTo delete one or more items, use the `--delete`\u002F`-d` options followed by the ids of the target items. Note that deleted items are automatically archived, and can be inspected or restored at any moment. Duplicate ids are automatically filtered out.\n\n```\n$ tb -d 1 2\n```\n\n### Delete Checked Tasks\n\nTo delete\u002Fclear all complete tasks at once across all boards, use the `--clear` option. Note that all deleted tasks are automatically archived, and can be inspected or restored at any moment. In order to discourage any possible accidental usage, the `--clear` option has no available shorter alias.\n\n```\n$ tb --clear\n```\n\n### Display Archive\n\nTo display all archived items, use the `--archive`\u002F`-a` option. Note that all archived items are displayed in timeline view, based on their creation date.\n\n```\n$ tb -a\n```\n\n### Restore Items\n\nTo restore one or more items, use the `--restore`\u002F`-r` option followed by the ids of the target items. Note that the ids of all archived items can be seen when invoking the `--archive`\u002F`-a` option. Duplicate ids are automatically filtered out.\n\n```\n$ tb -r 1 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`\u002F`-l` option followed by the desired attributes. Board names along with item traits can be considered valid listing attributes. For example to list all items that belong to the default `myboard` and are pending tasks, the following could be used;\n\n```\n$ tb -l myboard pending\n```\n\nThe by default supported listing attributes, together with their respective aliases, are the following;\n\n- `myboard` - Items that belong to `My board`\n- `task`, `tasks`, `todo` - Items that are tasks.\n- `note`, `notes` - Items that are notes.\n- `pending`, `unchecked`, `incomplete` - Items that are pending tasks.\n- `progress`, `started`, `begun` - Items that are in-progress tasks.\n- `done`, `checked`, `complete` - Items that complete tasks.\n- `star`, `starred` - Items that are starred.\n\n### Search Items\n\nTo search for one of more items, use the `--find`\u002F`-f` option, followed by your search terms.\n\n```\n$ tb -f documentation\n```\n\n### Runtime taskbook directory override\n\nTo override the configured storage location, use the `--taskbook-dir` flag or TASKBOOK_DIR environment variable. While Taskbook is designed to provide a multiple board approach for all of your projects, these options enable alternative use cases. Setup per project storage or run multiple global boards like home and work.\n\nNote, if both the flag and environment variable are present Taskbook will use the flag value.\n\n```\n$ tb --taskbook-dir .custom-taskbook-dir\n```\n\n```\n$ TASKBOOK_DIR=~\u002Fhometasks tb\n```\n\n## Development\n\nFor more info on how to contribute to the project, please read the [contributing guidelines](https:\u002F\u002Fgithub.com\u002Fklaudiosinani\u002Ftaskbook\u002Fblob\u002Fmaster\u002Fcontributing.md).\n\n- Fork the repository and clone it to your machine\n- Navigate to your local fork: `cd taskbook`\n- Install the project dependencies: `npm install` or `yarn install`\n- Lint the code for errors: `npm test` or `yarn test`\n\n## Related\n\n- [signale](https:\u002F\u002Fgithub.com\u002Fklaudiosinani\u002Fsignale) - Highly configurable logging utility\n- [qoa](https:\u002F\u002Fgithub.com\u002Fklaudiosinani\u002Fqoa) - Minimal interactive command-line prompts\n- [hyperocean](https:\u002F\u002Fgithub.com\u002Fklaudiosinani\u002Fhyperocean) - Deep oceanic blue Hyper terminal theme\n\n## Team\n\n- Klaudio Sinani [(@klaudiosinani)](https:\u002F\u002Fgithub.com\u002Fklaudiosinani)\n- Mario Sinani [(@mariosinani)](https:\u002F\u002Fgithub.com\u002Fmariosinani)\n\n## Sponsors\n\nA big thank you to all the people and companies supporting our Open Source work:\n\n- [Better Stack: Spot, Resolve, and Prevent Downtime.](https:\u002F\u002Fbetterstack.com\u002F)\n\n## License\n\n[MIT](https:\u002F\u002Fgithub.com\u002Fklaudiosinani\u002Ftaskbook\u002Fblob\u002Fmaster\u002Flicense.md)\n","Taskbook 是一个专为命令行环境设计的任务、看板和笔记管理工具。它通过简洁易用的语法帮助用户高效地管理任务和笔记，支持创建多个看板来组织内容，并提供优先级设置、收藏、搜索过滤等功能。此外，Taskbook 采用原子写入方式存储数据以防止损坏，同时支持自定义存储位置和数据恢复。该工具轻量且快速，适合那些偏好使用终端进行日常任务管理和笔记记录的开发者或高级用户。","2026-06-11 03:27:53","top_topic"]