{"id":17998129,"url":"https://github.com/cookiengineer/agenda","last_synced_at":"2025-03-26T04:31:39.971Z","repository":{"id":45729996,"uuid":"514173575","full_name":"cookiengineer/agenda","owner":"cookiengineer","description":":construction: :calendar: Offline-ready roadmap and task management planning tool","archived":false,"fork":false,"pushed_at":"2025-02-15T13:15:59.000Z","size":522,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-21T06:41:32.644Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":false,"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/cookiengineer.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,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-07-15T07:19:36.000Z","updated_at":"2024-02-06T06:43:15.000Z","dependencies_parsed_at":"2024-01-16T17:02:14.581Z","dependency_job_id":"e178810b-eb36-4af9-a372-936c7020c353","html_url":"https://github.com/cookiengineer/agenda","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cookiengineer%2Fagenda","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cookiengineer%2Fagenda/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cookiengineer%2Fagenda/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cookiengineer%2Fagenda/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cookiengineer","download_url":"https://codeload.github.com/cookiengineer/agenda/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245589265,"owners_count":20640254,"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":[],"created_at":"2024-10-29T21:24:05.873Z","updated_at":"2025-03-26T04:31:39.559Z","avatar_url":"https://github.com/cookiengineer.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Cookie Engineer's Agenda\n\n### Very opinionated Task Planner App\n\nThis is my attempt at creating a better Task Planner App. I don't\nlike any other task planner apps due to various reasons, which I\nam attempting to design/create differently here.\n\n## Opinions\n\n**Repeating tasks are never done**\n\nRepeating tasks reflect reoccuring tasks which consume time, but can\nnever be done and usually are repetitive in nature.\n\nFor example: household, groceries, sports and hobbies, meetings, cleaning etc.\n\n**Repeating tasks are per-weekday**\n\nRepeating tasks reflect reoccuring tasks, and they are repeating on\na specified-weekday basis, and not each specified-date-of-the-month.\n\nFor example: Every 3rd Saturday of the month at 20:00:00 or Every Monday and Wednesday.\n\n**Color palette reflects the assigned project**\n\nThe color palette is used to reflect the assigned project of each task.\nThe header bar allows to refresh the current view and all of its displayed\ntasks by enabling/disabling the selected project's button.\n\n**Tasks with (external) dependencies always have a specified deadline**\n\nTasks that rely on other people always have a specified deadline. A deadline\nis used to reflect when exactly this Task must be finished or prepared for.\nThis includes scheduled meeting appointments with others.\n\n**Tasks have a complexity**\n\nTasks have an assumed logical complexity, and there is always a backlog\nof tasks which have an assumed complexity in the planning phase. This\nassumed complexity reflects the Story Points in Scrum.\n\n**Tasks have an assumed time estimation and a measured time duration**\n\nTasks have an assumed time estimation, which is also measured in the\nform of the time duration. If the time duration is shorter/longer than\nthe initial estimation, it can be inferred that the user under- or\noverestimated the task complexities; and a more precise task estimation\ncan be suggested over time.\n\n**Task Planner Apps should offload mental work**\n\nWhile a user works on any given task, there's no need for the user to\nkeep track of other tasks and deadlines. The only thing that the user\nneeds to keep track of is when they started/stopped/resumed working on\nthe active task.\n\nEverything else should be the job of the Task Planner App, especially\nkeeping track of the tasks of lower immediate priority that are hard\nto remember over time.\n\n\n## Multiple Views\n\nThe Agenda Task Planner is based on the idea that in order to understand\nthe timeline of a project or to understand the tasks and their time estimations\nin a different context, there needs to be multiple views and projections,\nat any given time, for any given set of tasks.\n\nAs of now, these are the App Views and their proposed workflows:\n\n- [x] `Agenda` to prioritize tasks based on complexity and deadlines.\n- [x] `Calendar` to batch-schedule task deadlines via drag and drop.\n- [ ] `Gantt` to understand task dependencies and possible overdue times.\n- [ ] `Journal` to understand the success/failure history of a project.\n\n\n## Quickstart\n\n```bash\n# Run Web Server and Backend API\ncd /path/to/source;\ngo run ./main.go development;\n\n# Open your Web Browser\ngio open http://localhost:13337;\n```\n\nCLI Parameters:\n\n1. Use `development` parameter to use it without spawning a webview.\n2. Use `production` or no parameter to use with spawning a [webview/webview](https://github.com/webview/webview).\n\n\n## Installation\n\n```bash\n# Build binary\nbash ./make.sh;\n\n# Built binary contains all assets and dependencies\nsudo cp ./build/linux/linux-amd64 /usr/local/bin/agenda;\nsudo chmod +x /usr/local/bin/agenda;\n```\n\n\n## License\n\nAGPL3\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcookiengineer%2Fagenda","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcookiengineer%2Fagenda","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcookiengineer%2Fagenda/lists"}