{"id":30180551,"url":"https://github.com/klauscfhq/taskbook","last_synced_at":"2025-08-12T08:01:51.715Z","repository":{"id":37664882,"uuid":"121204738","full_name":"klaudiosinani/taskbook","owner":"klaudiosinani","description":"Tasks, boards \u0026 notes for the command-line habitat","archived":false,"fork":false,"pushed_at":"2025-04-01T08:39:14.000Z","size":459,"stargazers_count":9110,"open_issues_count":101,"forks_count":387,"subscribers_count":127,"default_branch":"master","last_synced_at":"2025-08-05T20:12:26.379Z","etag":null,"topics":["board","cli","note","task","todo"],"latest_commit_sha":null,"homepage":"","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/klaudiosinani.png","metadata":{"files":{"readme":"docs/readme.BG.md","changelog":null,"contributing":"contributing.md","funding":null,"license":"license.md","code_of_conduct":"code-of-conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"klaudiosinani","buy_me_a_coffee":"klaudiosinani","custom":"https://klaudiosinani.com/thanks"}},"created_at":"2018-02-12T05:37:22.000Z","updated_at":"2025-08-05T20:09:56.000Z","dependencies_parsed_at":"2024-11-05T16:02:00.928Z","dependency_job_id":"45af9d2f-3520-44a6-b9cb-c925f7783b67","html_url":"https://github.com/klaudiosinani/taskbook","commit_stats":null,"previous_names":["klaussinani/taskbook","klauscfhq/taskbook"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/klaudiosinani/taskbook","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klaudiosinani%2Ftaskbook","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klaudiosinani%2Ftaskbook/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klaudiosinani%2Ftaskbook/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klaudiosinani%2Ftaskbook/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/klaudiosinani","download_url":"https://codeload.github.com/klaudiosinani/taskbook/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klaudiosinani%2Ftaskbook/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270024697,"owners_count":24514054,"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","status":"online","status_checked_at":"2025-08-12T02:00:09.011Z","response_time":80,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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","note","task","todo"],"created_at":"2025-08-12T08:01:13.183Z","updated_at":"2025-08-12T08:01:51.688Z","avatar_url":"https://github.com/klaudiosinani.png","language":"JavaScript","readme":"\u003ch1 align=\"center\"\u003e\n  Taskbook\n\u003c/h1\u003e\n\n\u003ch4 align=\"center\"\u003e\n  Задачи, табла \u0026 бележки за командния ред\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\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://travis-ci.com/klaussinani/taskbook\"\u003e\n    \u003cimg alt=\"Build Status\" src=\"https://travis-ci.com/klaussinani/taskbook.svg?branch=master\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n## Описание\n\nЧрез използване на прост и минимален синтаксис на употреба, който изисква линеен път на обучение, taskbook Ви позволява ефективно да управлявате вашите задачи и бележки сред множество табла, в терминалната среда. Цялата информация бива автоматично записана в хранилището, с цел да предотврати повреди, и никога не бива споделено с никого или други. Изтритите елементи биват автоматично архивирани и могат да бъдат инспектирани или възстановени във всеки един момент.\n\nПрочетете този документ на:\n[简体中文](https://github.com/klaussinani/taskbook/blob/master/docs/readme.ZH.md), [Русский](https://github.com/klaussinani/taskbook/blob/master/docs/readme.RU.md), [Français](https://github.com/klaussinani/taskbook/blob/master/docs/readme.FR.md), [Deutsch](https://github.com/klaussinani/taskbook/blob/master/docs/readme.GER.md), [Portuguese](https://github.com/klaussinani/taskbook/blob/master/docs/readme.PT-BR.md), [日本語](https://github.com/klaussinani/taskbook/blob/master/docs/readme.JP.md), [한국어](https://github.com/klaussinani/taskbook/blob/master/docs/readme.KR.md), [Spanish](https://github.com/klaussinani/taskbook/blob/master/docs/readme.ES.md).\n\nВие вече можете да подкрепите етапа на разработка чрез [GitHub Sponsors](https://github.com/sponsors/klaussinani).\n\nПосетете [contributing guidelines](https://github.com/klaussinani/taskbook/blob/master/contributing.md#translating-documentation) за да узнаете повече как да преведете този документ на повече езици.\n\nПосетете [Gitter](https://gitter.im/klaussinani/taskbook) или [Twitter](https://twitter.com/klaussinani) за да споделите вашите идеи за този проект.\n\n## Акценти\n\n- Организирай задания \u0026 бележки към табла\n- Изгледи Табла \u0026 времева линия\n- Механизми за Приоритет \u0026 любими\n- Търси \u0026 филтрирай елементи\n- Архивирай \u0026 възстанови изтрити елементи\n- Лек \u0026 бърз\n- Данните биват атомично записани за съхранение\n- Персонални местоположения за съхранение\n- Изглед Прогрес\n- Елементарен \u0026 минимален синтаксис за употреба\n- Обновяване на известията\n- Конфигуриране чрез `~/.taskbook.json`\n- Данните се съхраняват в JSON файл на адрес `~/.taskbook/storage`\n\nВижте акценти в [taskbook board](https://raw.githubusercontent.com/klaussinani/taskbook/master/media/highlights.png).\n\n## Съдържание\n\n- [Описание](#описание)\n- [Акценти](#акценти)\n- [Инсталиране](#инсталиране)\n- [Употреба](#употреба)\n- [Изгледи](#изгледи)\n- [Конфигурация](#конфигурация)\n- [Ръководство за полети](#ръководство-полети)\n- [Разработка](#разработка)\n- [Свързани](#свързани)\n- [Отбор](#отбор)\n- [Лиценз](#лиценз)\n\n## Инсталиране\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:** Поради специфичната природа на снап пакетите, съхраняваните \u0026 конфигурационни данни ще бъдат записвани под [`$SNAP_USER_DATA`](https://docs.snapcraft.io/reference/env) променлива вместо общата `$HOME` такава.\n\n## Употреба\n\n```\n$ tb --help\n\n  Usage\n    $ tb [\u003coptions\u003e ...]\n\n    Опции\n        none             Покажи Изглед табло\n      --archive, -a      Покажи архивирани елементи\n      --begin, -b        Старт/пауза задача\n      --check, -c        Маркирай/Де-маркирай задачи\n      --clear            Изтрий всички маркирани елементи\n      --copy, -y         Копирай описание на елемент\n      --delete, -d       Изтрий елемент\n      --edit, -e         Редактирай описание на елемент\n      --find, -f         Търси елементи\n      --help, -h         Покажи помощно съобщение\n      --list, -l         Подреди елементи по атрибути\n      --move, -m         Премести елемент между табла\n      --note, -n         Създай бележка\n      --priority, -p     Обнови приоритет на задача\n      --restore, -r      Възстанови елементи от архива\n      --star, -s         Сложи звезда/махни звезда\n      --task, -t         Създай задача\n      --timeline, -i     Покажи Изглед Времева линия\n      --version, -v      Покажи инсталирана версия\n\n    Примери\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 --task @coding @reviews Review PR #42\n      $ tb --task @coding Improve documentation\n      $ tb --task Make some buttercream\n      $ tb --timeline\n```\n\n## Изгледи\n\n### Изглед табло\n\nИзвикването на taskbook без каквито и да е аргументи ще покаже всички съхранени елементи, групирани в техните респективни табла.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg alt=\"Boards\" width=\"60%\" src=\"../media/header-boards.png\"/\u003e\n\u003c/div\u003e\n\n### Изглед Времева линия\n\nЗа да покажете всички елементи във времеви изглед, базирано на тяхната дата на създаване, `--timeline`/`-i` трябва да бъде използван.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg alt=\"Timeline View\" width=\"62%\" src=\"../media/timeline.png\"/\u003e\n\u003c/div\u003e\n\n## Конфигурация\n\nЗа да настройте taskbook навигирайте до `~/.taskbook.json` файлът и модифицирайте всеки от атрибутите според предпочитанията ви. За нулиране до стойности по подразбиране, просто изтрийте конфигурационния файл от домашната ви директория.\n\nСледната илюстрация показва нагледно всички налични опции и респективно техните стойности по подразбиране.\n\n```json\n{\n  \"taskbookDirectory\": \"~\",\n  \"displayCompleteTasks\": true,\n  \"displayProgressOverview\": true\n}\n```\n\n### В Детайл\n\n##### `taskbookDirectory`\n\n- Type: `String`\n- Default: `~`\n\nФайлов път - системен за инициализиране, напр.: `/home/username/the-cloud` или `~/the-cloud`\n\nАко бъде оставено празно, домашната папка `~` ще бъде зададено и настроено на `~/.taskbook/`.\n\n##### `displayCompleteTasks`\n\n- Type: `Boolean`\n- Default: `true`\n\nПокажи изпълнени задачи.\n\n##### `displayProgressOverview`\n\n- Type: `Boolean`\n- Default: `true`\n\nПокажи прогреса под времевата линия и изглед табло.\n\n## Изглед за полети\n\nСледното е малко въведение, съдържащо редица примери как да използвате програмата.\nАко откриете грешка или мислите че определен пример не е достатъчно ясен можете за подадете сигнал за проблем на [issue](https://github.com/klaussinani/taskbook/issues/new/choose) или [pull request](https://github.com/klaussinani/taskbook/compare).\n\n### Създай задача\n\nЗа създаване на нова задача, ползвай `--task`/`-t` опция с описание следващо веднага след.\n\n```\n$ tb -t Improve documentation\n```\n\n### Създай бележка\n\nЗа нова бележкар ползвай `--note`/`-n` опция с тяло на бележката веднага след.\n\n```\n$ tb -n Mergesort worse-case O(nlogn)\n```\n\n### Създай табло\n\nТаблата биват автоматично инициализирани при създаване на нова задачи или бележка. За 1 или повече табла, добавете техните имена разделени с префикс `@` символ, в описанието на бъдещата задача за създаване. Като резултат ново създадения елемент ще принадлежи към всички описани табла. По подразбиране ако липсва име на табло, ще получите стандартното; `My Board`.\n\n```\n$ tb -t @coding @docs Update contributing guidelines\n```\n\n### Провери задача\n\nЗа маркиране на задача като завършена/незавършена, използвай `--check`/`-c` опция последвана от ид на желаната задача. Имайте предвид че опцията ще се обнови до антонима си — статус ‘завършено’, като маркиране на завършена задача ще се преобразува като изчакваща, а тя от своя страна като завършена. Дублиращи се ид се филтрират автоматично.\n\n```\n$ tb -c 1 3\n```\n\n### Започни задача\n\nЗа отбелязване на задача като започната/на пауза, използвайте `--begin`/`-b` опция последвано от ид на желаните задачи. Функционалността на тази опция е същата като горе-споменатата `--check` option.\n\n```\n$ tb -b 2 3\n```\n\n### Сложи звезда\n\nЗа отбелязване на един или повече елемента като любим, използвайте `--star`/`-s` опция последвано от ид на желаните задачи. Функционалността на тази опция е същата като горе-споменатата `--check` option.\n\n```\n$ tb -s 1 2 3\n```\n\n### Копирай описание на елемент\n\nЗа копиране в клипборда използвай `--copy`/`-y` последвана от ид на желаните елемента. Опцията включва също и знакът за нов ред като разделител на всяка двойка описание, което води до изчистен и лесно за прочитане формат при поставяне.\n\n```\n$ tb -y 1 2 3\n```\n\n### Покажи табла\n\nВлагането на taskbook без никакви аргументи ще покаже всички съхранени елементи, групирани в своите табла.\n\n```\n$ tb\n```\n\n### Покажи времева линия\n\nЗа да видите всички елементи под формата на времеви отрязък, на база дата на създаване, `--timeline`/`-i` опция може да бъде използвана.\n\n```\n$ tb -i\n```\n\n### Задай Приоритет\n\nЗа задаване на ниво приоритет, прибавете `p:x` в описанието на задачата, където x може да бъде цяло число със стойност `1`, `2` или `3`.  Забележете че всички задачи се създават с приоритет нормално - `1`.\n\n- `1` - Нормален приоритет\n- `2` - Среден приоритет\n- `3` - Висок приоритет\n\n```\n$ tb -t @coding Fix issue `#42` p:3\n```\n\nЗа обновяване на нивото на приоритет на отделна задача след нейното създаване, използвайте `--priority`/`-p` опция заедно с ид на желаната задача, с префикс `@` символ и цяло число със стойност `1`, `2` or `3`. Имайте предвид че реда на поставяне  ид на  конкретната задача и нивото на приоритет не са от значение.\n\n```\n$ tb -p @1 2\n```\n\n### Премести елемент\n\nЗа преместване на елемент към един или повече табла, използвайте `--move`/`-m` опция, последвана от ид на желания елемент както и името на борда – дестинация. По подразбиране `My board` може да бъде извикан с ключова дума `myboard`. Редът на ид и името на борда не са от значение.\n\n```\n$ tb -m @1 myboard reviews\n```\n\n### Изтриване на елемент\n\nЗа изтриване на един или повече елемента, използвайте `--delete`/`-d` опция последвана от ид на желаните елементи. Имайте предвид че изтритите елементи биват архивирани автоматично и могат да бъдат инспектирани или възстановени във всеки един момент. Дублирани елементи се филтрират автоматично.\n\n```\n$ tb -d 1 2\n```\n\n### Изтриване на маркирани елементи\n\nЗа изтриване/изчистване на завършени задачи наведнъж сред всички табла, използвайте опцията `--clear`. Забележете че всички изтрити задачи се архивират автоматично и могат да бъдат инспектирани или възстановени по-всяко време. За да се избегнат инциденти се използва флаг `--clear` в пълна форма и той няма аналог.\n\n```\n$ tb --clear\n```\n\n### Покажи Архив\n\nЗа преглед на всички архивирани елементи, използвайте `--archive`/`-a` опция. Моля имайте предвид че всички архивирани елементи се показват в изглед Времева линия, на базата на датата на създаването им.\n\n```\n$ tb -a\n```\n\n### Възстанови елементи\n\nЗа възстановяване на един или повече елемента, използвайте `--restore`/`-r` опция, последвана от ид на желаните елементи. Моля вземете предвид че всички архивирани елементи могат да бъдат видени при вмъкване на `--archive`/`-a` опция. Дублиращи се ид се филтрират автоматично.\n\n```\n$ tb -r 1 2\n```\n\n### Елементи от списъка\n\nЗа да видите списъка с елементи, групирани по даден показател, използвайте опция `--list`/`-l` последвана от желаните атрибути. Имената на таблата, заедно с техните детайли се считат за валидни опции. Например за списък с всички елементи които принадлежат на списъка по-подразбиране `myboard` и техните прилежащи задачи, следното може да се използва;\n\n```\n$ tb -l myboard pending\n```\n\nПредстоящите представляват атрибути по-подразбиране, заедно с техните опции, както следва;\n\n- `myboard` - Елементи които принадлежат към `My board`\n- `task`, `tasks`, `todo` - Елементи, тип задачи.\n- `note`, `notes` - Елементи, тип бележки.\n- `pending`, `unchecked`, `incomplete` - Елементи, които са тип Изчакващи.\n- `progress`, `started`, `begun` - Елементи, представляващи задачи \"В процес на\".\n- `done`, `checked`, `complete` - Елементи, от типа Завършени задачи.\n- `star`, `starred` - Елементи с звезда „любими„.\n\n### Търси елементи\n\nЗа търсене на един или повече елементи, използвайте `--find`/`-f` опция, последвана от вашият низ за търсене.\n\n```\n$ tb -f documentation\n```\n\n## Разработка\n\nЗа детайли как да помогнете на този проект, моля прочетете [contributing guidelines](https://github.com/klaussinani/taskbook/blob/master/contributing.md).\n\n- Изберете \"Форк\" за това хранилище и клонирайте към своята машина.\n- Навигирайте към локалното място на съхранение за проекта: `cd taskbook`\n- Инсталирайте необходимите зависимости: `npm install` или `yarn install`\n- Провери кода за грешки: `npm test` или `yarn test`\n\n## Свързани\n\n- [signale](https://github.com/klaussinani/signale) - Силно конфигурируема помощна програма за регистриране\n- [qoa](https://github.com/klaussinani/qoa) - Минимални интерактивни подкани тип команден прозорец\n- [hyperocean](https://github.com/klaussinani/hyperocean) - Дълбочинно синьо-океанска тема с терминал Хипер\n\n## Отбор\n\n- Klaus Sinani [(@klaussinani)](https://github.com/klaussinani)\n- Mario Sinani [(@mariosinani)](https://github.com/mariosinani)\n\n## Лиценз\n\n[MIT](https://github.com/klaussinani/taskbook/blob/master/license.md)\n","funding_links":["https://github.com/sponsors/klaudiosinani","https://buymeacoffee.com/klaudiosinani","https://klaudiosinani.com/thanks","https://github.com/sponsors/klaussinani"],"categories":["Packages","包","Command-line apps","Tool","目录"],"sub_categories":["Command-line apps","命令行程序","命令行应用"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fklauscfhq%2Ftaskbook","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fklauscfhq%2Ftaskbook","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fklauscfhq%2Ftaskbook/lists"}