{"id":42833989,"url":"https://github.com/n0rdy/remindme","last_synced_at":"2026-01-30T11:37:58.268Z","repository":{"id":181663481,"uuid":"667095924","full_name":"n0rdy/remindme","owner":"n0rdy","description":"A simple terminal reminder app","archived":false,"fork":false,"pushed_at":"2025-03-27T16:32:48.000Z","size":3722,"stargazers_count":25,"open_issues_count":2,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-27T17:36:48.239Z","etag":null,"topics":["cli-app","go","golang","reminder","reminder-app","terminal-app","terminal-reminder-app"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/n0rdy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2023-07-16T16:14:54.000Z","updated_at":"2025-03-27T16:32:50.000Z","dependencies_parsed_at":null,"dependency_job_id":"f02a5722-6892-4313-b281-6be04ace6057","html_url":"https://github.com/n0rdy/remindme","commit_stats":null,"previous_names":["n0rdy/remindme"],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/n0rdy/remindme","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n0rdy%2Fremindme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n0rdy%2Fremindme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n0rdy%2Fremindme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n0rdy%2Fremindme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/n0rdy","download_url":"https://codeload.github.com/n0rdy/remindme/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n0rdy%2Fremindme/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28911825,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-30T08:15:08.179Z","status":"ssl_error","status_checked_at":"2026-01-30T08:14:31.507Z","response_time":66,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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-app","go","golang","reminder","reminder-app","terminal-app","terminal-reminder-app"],"created_at":"2026-01-30T11:37:57.440Z","updated_at":"2026-01-30T11:37:58.259Z","avatar_url":"https://github.com/n0rdy.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Terminal reminder app\n\n## Description\nHello there!\n\nThe idea behind this app is to use it for short-term reminders, e.g. to remind you to do something in 2 hours or in 10 minutes.\nThe reminders are set in terminal, and the app will notify you about the reminder via OS-specific reminders.\n\nReminders are stored in SQLite database, so they will persist even if the app is stopped and started again.\nHowever, if there is an issue with the SQLite setup, the app will still work, but the reminders will be stored in memory and will be lost after the app is stopped.\nSQLite is bundled with the app, so there is no need to install it separately.\n\nThe flow of the app is as follows:\n![](https://github.com/n0rdy/remindme/blob/master/docs/flow.gif)\n\nReminders are cross-platform compatible and are supposed to work on Windows, Linux, and MacOS.\nSo far, the app has been tested on:\n- MacOS Ventura 13.5 with Intel Core i9 x64 CPU and zsh 5.9 (x86_64-apple-darwin22.1.0)\n- MacOS Ventura 13.5 with Apple M2 Max x64 CPU and zsh 5.9 (x86_64-apple-darwin22.0)\n- Ubuntu 22.04.2 LTS (via VirtualBox) with Intel Core i9 x64 CPU and bash 5.1.16(1)-release (x86_64-pc-linux-gnu)\n- Fedora Workstation 38 (via VirtualBox) with Intel Core i9 x64 CPU and bash 5.2.15(1)-release (x86_64-redhat-linux-gnu)\n- Windows 10 Home (version 21H2) with Intel Core i5 x64 CPU and Windows PowerShell 5.1.19041.1682\n\nHave fun! =)\n\n## Installation\n### Prerequisites\n- [Go](https://golang.org/doc/install) (version 1.22 or higher) if you want to build the app from the source code.\n\n### Manual\nDownload the latest release for your OS from [GitHub](https://github.com/n0rdy/remindme/releases).\n\n### MacOS\n- via Homebrew:\n```shell\nbrew tap n0rdy/n0rdy\nbrew install remindme\n```\n\n### Linux\n#### via APT\n##### Prerequisites\nTo enable, add the following file /etc/apt/sources.list.d/fury.list:\n```text\ndeb [trusted=yes] https://apt.fury.io/n0rdy/ /\n```\nYou can do this either manually or by running the following command:\n```shell\necho \"deb [trusted=yes] https://apt.fury.io/n0rdy/ /\" \u003e /etc/apt/sources.list.d/fury.list\n```\nIf you experienced this error:\n```text\nbash: /etc/apt/sources.list.d/fury.list: Permission denied\n```\ntry to do the following:\n```shell\nsudo -i\n# enter your password\necho \"deb [trusted=yes] https://apt.fury.io/n0rdy/ /\" \u003e /etc/apt/sources.list.d/fury.list\n# click Ctrl+D to exit\n```\n\n##### Installation\n```shell\nsudo apt update \u0026\u0026 sudo apt install remindme\n```\n\n#### via YUM\n##### Prerequisites\nTo enable, add the following file /etc/yum.repos.d/fury.repo:\n```text\n[fury]\nname=Gemfury n0rdy Private Repo\nbaseurl=https://yum.fury.io/n0rdy/\nenabled=1\ngpgcheck=0\n```\n\n##### Installation\n```shell\nsudo yum install remindme\n```\n\n## Usage\n### Starting app\nTo start the app, run the following command in the terminal:\n```shell\nremindme start\n```\nUnder the hood, the HTTP server is started on port 15555.\n\nIt is possible to specify the port to start the server on by either:\n- using the `--port` flag, e.g.:\n```shell\nremindme start --port 15556\n```\n- setting the `REMINDME_PORT` environment variable to the desired port number.\n\n### Adding a reminder\nThere are several ways to add a reminder:\n\n- to be reminded in a certain amount of time, e.g. in 2 hours 30 minutes 10 seconds:\n```shell\nremindme in --hr 2 --min 30 --sec 10 --about \"Do something cool\"\n```\n\n- to be reminded at a certain time, e.g. at 22:30:\n```shell\nremindme at --time 22:30 --about \"Do something cool\"\n```\nIt is also possible to specify the time in 12-hour A.M./P.M format:\n```shell\nremindme at --pm 10:30 --about \"Do something cool\"\n``` \nor for 10:30 A.M.:\n```shell\nremindme at --am 10:30 --about \"Do something cool\"\n```\n\n### List the existing reminders\n- to see the list of all reminders, run:\n```shell\nremindme list\n```\n\nThe `list` command also supports sorting the list of reminders by ID, message or time in an ascending or descending order. \nBy default, the list is provided in a random order. If the sorting is requested, but the sorting order is not specified, the ascending order is used.\n- to sort by ID, run:\n```shell\nremindme list --sort --id\n```\n- to sort by message, run:\n```shell\nremindme list --sort --message\n```\n- to sort by time in descending order, run:\n```shell\nremindme list --sort --time --desc\n```\n\n### Canceling a reminder\n- to cancel a reminder, run:\n```shell\nremindme cancel --id 1\n```\nwhere `1` is the ID of the reminder to be cancelled. The ID can be obtained by running `remindme list` command.\n\n- to cancel all reminders, run:\n```shell\nremindme cancel --all\n```\n\n### Changing the reminder message or/and time\n- to change the message of a reminder, run:\n```shell\nremindme change --id 1 --about \"Do something else, but also cool\"\n```\nwhere `1` is the ID of the reminder to be changed. The ID can be obtained by running `remindme list` command.\n\n- to change the time of a reminder, run:\n```shell\nremindme change --id 1 --time 22:30\n```\nwhere `1` is the ID of the reminder to be changed. The ID can be obtained by running `remindme list` command.\n\n- it is possible to change the time by postponing it by a certain amount of time, e.g. by 2 hours 30 minutes 10 seconds:\n```shell\nremindme change --id 1 --postpone --hr 2 --min 30 --sec 10\n```\nwhere `1` is the ID of the reminder to be changed. The ID can be obtained by running `remindme list` command.\n\n### Stopping the app\n- to stop the app, run the following command in the terminal:\n```shell\nremindme stop\n```\n\n### Logs\n#### Printing logs\n- to print the logs, run the following command in the terminal:\n```shell\nremindme admin logs print\n```\nIt is possible to specify which logs to print: client or server logs by using the `--client` or `--server` flags respectively.\nBy default, client logs are printed.\n\n#### Deleting log files\n- to delete the log files, run the following command in the terminal:\n```shell\nremindme admin logs delete\n```\nIt is possible to specify which log file to delete: client or server logs by using the `--client` or `--server` flags respectively.\nBy default, both client and server log files are deleted.\n\n### Help\n- to see the list of all available commands, run:\n```shell\nremindme help\n```\n\n### Completion\nremindme app provides a possibility to use completion for the commands and flags. To generate the completion, run the following command in the terminal:\n```shell\nremindme completion\n```\nThis will generate the completion for the current shell. \nTo enable the completion for the current shell run, use this command:\n```shell\nsource \u003c(remindme completion)\n```\nTo enable the completion for the current shell permanently, add this line to your `.bashrc`, `.zshrc` or `config.fish` file:\n```shell\nsource \u003c(remindme completion)\n```\n\nIf you are on Windows with PowerShell, it is possible to generate the completion by running the following command:\n```shell\nremindme completion\n```\nPlease, check the [PowerShell documentation](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/register-argumentcompleter?view=powershell-7.3) for more information about loading completions for this shell type.\n\n### Documentation generation\nTo generate the documentation for the app in the MD-format, run the following command in the terminal:\n```shell\nremindme docs --dir \"path_to_dir\"\n```\nIf the `--dir` flag is not specified, the documentation will be generated in the temp directory on your machine - the path to the directory will be printed to the terminal as a result of `docs` command execution.\nYou can find the same docs (as generated) within the [docs](https://github.com/n0rdy/remindme/blob/master/docs/remindme.md) folder on GitHub.\n\n### Additional information\nPlease, note that some flags have shortcuts, e.g. `--about` can be replaced with `-a`, `--time` with `-t`, etc. To see the full list of shortcuts, run the `remindme help`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fn0rdy%2Fremindme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fn0rdy%2Fremindme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fn0rdy%2Fremindme/lists"}