{"id":18572419,"url":"https://github.com/a/dela","last_synced_at":"2026-01-02T11:23:18.350Z","repository":{"id":180162953,"uuid":"664711593","full_name":"A/dela","owner":"A","description":"CLI to list markdown todos","archived":false,"fork":false,"pushed_at":"2023-11-15T08:01:10.000Z","size":4860,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-13T23:34:10.871Z","etag":null,"topics":["cli","markdown","obsidian","obsidian-md","task-manager","todo"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/A.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-07-10T15:18:54.000Z","updated_at":"2025-02-11T10:46:40.000Z","dependencies_parsed_at":"2023-11-15T08:45:21.707Z","dependency_job_id":null,"html_url":"https://github.com/A/dela","commit_stats":null,"previous_names":["a/dela"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/A/dela","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/A%2Fdela","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/A%2Fdela/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/A%2Fdela/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/A%2Fdela/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/A","download_url":"https://codeload.github.com/A/dela/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/A%2Fdela/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272678068,"owners_count":24975061,"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-29T02:00:10.610Z","response_time":87,"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":["cli","markdown","obsidian","obsidian-md","task-manager","todo"],"created_at":"2024-11-06T23:06:09.232Z","updated_at":"2026-01-02T11:23:18.317Z","avatar_url":"https://github.com/A.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Dela\n\n![dela](./imgs/dela.png)\n\n### Installation\n\n```\npip install --user dela\n```\n\n### Features\n\n- Getting all todos against a markdown files collection\n- Dates support\n- Tags support\n- Flexible filters\n- Flexible Sorting\n- Frontmatter support\n\n\n### Examples\n\n```bash\ndela list # By default prints all todos with [~], [n] and [ ] checkboxes\ndela list -s=' ,s' # prints todos only with statuses [ ] and [s]\ndela list --today # prints only todos with default statuses with a date equal or earliear then today\ndela list -t=#tag # prints only todos that have tag #tag\ndela list -u -s='~,n, ,s' #prints todos with given status including upcoming ones\n```\n\n### Help\n\n```\nCLI to list todos from markdown files and obsidian vaults.\n\nUsage:\n  dela -h | --help\n  dela --version\n  dela list [-v] [--today|--upcoming] [--all|--statuses=\u003cstr\u003e] [--tags=\u003cstr\u003e] [--sort_by=\u003cstr\u003e] [--format=\u003cstr\u003e] [\u003cglob\u003e]\n\n\nOptions:\n  -h --help                     Show this screen\n  -v --verbose                  Enable logging\n  --version                     Show version.\n\n  -s=\u003cstr\u003e --statuses=\u003cstr\u003e     Filter by status [default: ~,n, ]\n  -t=\u003cstr\u003e --tags=\u003cstr\u003e         Filter by tag (#work, #home, etc)\n\n  --today                       Show only tasks due today or earlier\n  -u --upcoming                 Show future tasks\n  -a --all                      Show all todos\n\n  --sort_by=\u003ckey\u003e               Sort by given key or comma-separated keys\n\n  --format=\u003cstring\u003e             Format result with given template string.\n\n\nTodo statuses:\n    Todo status is a symbol placed in the square buckets ([x], [ ], [~], etc). You can use\n    whatever you want, `dela` doesn't have eny presets, except default `--status=~,n, `,\n    which you can overwrite.\n\n\nUpcoming Tasks:\n\n    If a task has a date in future, it's hidden by default. To see such tasks in the output,\n    add the `--upcoming` flag.\n\n\nSorting:\n\n    By default todos are sorted by `--status` value according to the order of given statuses,\n    and then by date to place todos with dates to the top of the list (due date sounds important,\n    right?). You can sort todos by passing an attribute name to the  `--sort_by` flag.\n    Possible values are:\n\n    - title\n    - date\n    - status\n    - tags\n    - file\n\n\nFormatting output:\n\n    You can use your own template with the `--format` flag. Unicode colors are supported:\n\n    For example:\n\n        dela list --format='- [$status] $file: $title'\n\n    Next variables are supported:\n\n    - $title\n    - $date\n    - $status\n    - $tags\n    - $file\n    - $line\n\nFrontmatter Support:\n\n    You can use frontmatter to override file-level todo states, it can be useful in the next cases:\n        - Automatically consider all todos in `todos_done.md` as done\n        - To set `date` as `today` automatically if a todo is placed in `today.md`\n        - To automatically set per-file tags\n\n    To achieve this, you can add a frontmatter in a manner like below:\n\n    ```\n    ---\n    dela:\n        date: today # it's a specific keyword. Standard dates in a YYYYmmdd format also supported\n        status: 'x' # override status for all todos in the file\n        tags: # append per-file tags\n            - per_file_tag\n    ---\n    ```\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa%2Fdela","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fa%2Fdela","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa%2Fdela/lists"}