{"id":18103670,"url":"https://github.com/fcanas/dit","last_synced_at":"2026-04-29T15:32:44.941Z","repository":{"id":149138351,"uuid":"276738465","full_name":"fcanas/dit","owner":"fcanas","description":"Basic CLI for Reminders on macOS","archived":false,"fork":false,"pushed_at":"2022-01-25T02:42:58.000Z","size":40,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"canon","last_synced_at":"2025-03-29T06:02:22.740Z","etag":null,"topics":["cli-app","macos","reminder-application"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fcanas.png","metadata":{"files":{"readme":"README.md","changelog":"Changelog.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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}},"created_at":"2020-07-02T20:23:01.000Z","updated_at":"2022-10-20T12:10:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"c0c7d807-acbf-4c67-a110-087f95899641","html_url":"https://github.com/fcanas/dit","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fcanas%2Fdit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fcanas%2Fdit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fcanas%2Fdit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fcanas%2Fdit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fcanas","download_url":"https://codeload.github.com/fcanas/dit/tar.gz/refs/heads/canon","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247441005,"owners_count":20939235,"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":["cli-app","macos","reminder-application"],"created_at":"2024-10-31T22:12:50.920Z","updated_at":"2026-04-29T15:32:44.910Z","avatar_url":"https://github.com/fcanas.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dit\n\nA command line interface for Reminders on macOS.\n\ndit is not complete, and its structure would have to change substantially to become complete.\n\n* See existing Lists\n* Query Reminders in those lists\n  - filtering by completion status\n  - for due date in open or closed time ranges\n  - for completion date in open or closed time ranges  \n* Create Reminders\n  - in arbitrary lists\n  - in a default list\n  - with a due date specified as an interval from today\n  - with a recurrence specified as an time interval[\u003csup\u003e‡\u003c/sup\u003e](#recurrence)\n* Mark reminders as done/undone\n\n## Installing\n\nThe `dit` CLI tool is available via a [Homebrew](https://brew.sh) [tap](https://docs.brew.sh/Taps#the-brew-tap-command):\n\n`brew install fcanas/tap/dit`\n\nor\n\n```\nbrew tap fcanas/tap\nbrew install dit\n```\n\n## Documentation\n\n### `dit`\n\n```\nOVERVIEW: Manipulate reminders\n\nUSAGE: dit \u003csubcommand\u003e\n\nOPTIONS:\n  --version               Show the version.\n  -h, --help              Show help information.\n\nSUBCOMMANDS:\n  query (default)         Show Reminders.\n  create                  Create a new reminder.\n  lists                   Display Lists of Reminders\n  configure               Configure default settings.\n  do                      Mark reminders as done.\n\n  See 'dit help \u003csubcommand\u003e' for detailed help.\n```\n\n### `dit query`\n\n```\nOVERVIEW: Show Reminders.\n\nDate filters --starting and --ending operate on the due date for\nincomplete tasks and the completion date for complete tasks.\n\nUSAGE: dit query [--all] [--complete] [--incomplete] [--list \u003clist\u003e] [--starting \u003cstarting\u003e] [--ending \u003cending\u003e]\n\nOPTIONS:\n  --all/--complete/--incomplete\n                          Show Reminders based on completion status. (default: incomplete)\n  -l, --list \u003clist\u003e       The name of the list to query. Default can be set with the\n                          configure command. \n  -s, --starting \u003cstarting\u003e\n                          Beginning of time range to query within, specified relative to\n                          today. e.g. 2d specifies to search for Reminders\n                          beginning two days from now. \n  -e, --ending \u003cending\u003e   End of time range to query within, specified relative to today.\n                          e.g. 3w specifies to search for Reminders before three\n                          weeks from now. \n  --version               Show the version.\n  -h, --help              Show help information.\n```\n\n### `dit create`\n\n```\nOVERVIEW: Create a new reminder.\n\nUSAGE: dit create [--list \u003clist\u003e] \u003ctitle\u003e [--due-in \u003cdue-in\u003e] [--repeats \u003crepeats\u003e]\n\nARGUMENTS:\n  \u003ctitle\u003e                 Title for the new reminder \n\nOPTIONS:\n  -l, --list \u003clist\u003e       The list to create the reminder in \n  -d, --due-in \u003cdue-in\u003e   An interval specifying how far from now the reminder is due,\n                          specified in minutes, hours, days,\n                          weeks, months, and years. These units\n                          can be combined in ascending order, e.g. 1y2m17h22s \n  -r, --repeats \u003crepeats\u003e How often the reminder should repeat, in days,\n                          weeks, months, and years. These units\n                          cannot be comined. e.g. 3w, y, d,\n                          24d \n  --version               Show the version.\n  -h, --help              Show help information.\n```\n\n\u003ca name=\"recurrence\"\u003e\u003csup\u003e‡\u003c/sup\u003e\u003c/a\u003e Recurrence intervals can currently only be made in the form of \"Every _N_ ( days | weeks | months | years )\"\n\n### `dit lists`\n\n```\nOVERVIEW: Display Lists of Reminders\n\nUSAGE: dit lists\n\nOPTIONS:\n  --version               Show the version.\n  -h, --help              Show help information.\n```\n\n### `dit configure`\n\n```\nOVERVIEW: Configure default settings.\n\nUSAGE: dit configure [--default-list \u003cdefault-list\u003e]\n\nOPTIONS:\n  -d, --default-list \u003cdefault-list\u003e\n                          Set the default List when creating a reminder \n  --version               Show the version.\n  -h, --help              Show help information.\n```\n\n### `dit do`\n\n```\nOVERVIEW: Mark reminders as done.\n\nDo is an interactive command.The flags and options form a query, and present a numbered\nlist of items that can be selected for toggling. Date filters --starting and\n--ending operate on the due date for incomplete tasks and the completion date for\ncomplete tasks.\n\nUSAGE: dit do [--all] [--complete] [--incomplete] [--list \u003clist\u003e] [--starting \u003cstarting\u003e] [--ending \u003cending\u003e]\n\nOPTIONS:\n  --all/--complete/--incomplete\n                          Show Reminders based on completion status. (default: incomplete)\n  -l, --list \u003clist\u003e       The name of the list to query. Default can be set with the\n                          configure command. \n  -s, --starting \u003cstarting\u003e\n                          Beginning of time range to query within, specified relative to\n                          today. e.g. 2d specifies to search for Reminders\n                          beginning two days from now. \n  -e, --ending \u003cending\u003e   End of time range to query within, specified relative to today.\n                          e.g. 3w specifies to search for Reminders before three\n                          weeks from now. \n  --version               Show the version.\n  -h, --help              Show help information.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffcanas%2Fdit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffcanas%2Fdit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffcanas%2Fdit/lists"}