# ICOR for Life - Planner **Plan your week once, in one place.** Your tasks are in Todoist, in ClickUp, in starred emails and in four calendars. Planning a week means re-reading all of them and holding the answer in your head. This brings them into one board: drag a card onto a morning or an afternoon, and that part of the week is decided. Part of the [ICOR for Life](https://myicor.com) suite. ## What it is for Planning fails at the gathering step, not the deciding step. By the time you have checked four apps you have spent the energy you needed for the actual choice, and you are choosing from whatever you still remember. Put everything on one surface and the choice becomes easy, because you can finally see all of it at once. Everything lands in your vault as plain markdown notes, so your plan is yours and readable without this plugin. ## Getting started You do not need an account to start. Open the Planner from the button under the sidebar logo, add a task by hand in the tray, and drag it onto a day. Connect sources when you want them, one at a time, from the settings page. ## What you can connect **Tasks.** Todoist and ClickUp. **Email.** Starred or flagged mail becomes a task. Gmail, iCloud and Fastmail have one-click presets and ask for an app password, never your account password. Any other IMAP host works by typing it in. Outlook and Microsoft 365 connect through their own sign-in. **Calendars.** As many as you like, one iCal address each: Google, iCloud, Proton, Outlook or anything else that publishes a feed. Each gets a name and a colour, an event in two calendars shows once, and one feed failing leaves the others working and tells you which one broke. Every source is optional. Connect none and the board still works. ## The one rule: your notes are a mirror Tasks from a connected source are a mirror of that source. - **Complete here and it completes there.** That is the "Complete on source" switch, and it is off until you turn it on. - **Edit here and it syncs there.** Title, due date, priority and the note body go back to Todoist and ClickUp, behind the "Push edits to source" switch. - **Changed there, changed here.** Every sync pulls what changed at the source. If the same thing changed on both sides, the source wins. - **Deleted there, it disappears here.** The note moves to Obsidian's trash, where you can get it back. Your own planning is never part of this. The day a card sits on, its half of the day, its order, the star for the week and the note you linked it to live only in your vault, and no sync touches them. ## The board and the tray The **board** is your week in morning and afternoon lanes. Drag a card onto one and it is scheduled. The **tray** sits in the right sidebar with four tabs: unscheduled tasks, your calendar, your routines and your habits. **Routines and habits** live here too, so the things you do every week are on the same surface as the things you only do once. Any card can be **pinned to this week** from its menu. Pinned cards sit at the top of the tray under PINNED THIS WEEK and wear a WEEK chip on the board. ## The week note Beside the board there is one note per week, in `02 Planner/Weeks/`, and a tab that reads and writes it. It holds two things. **Weekly priorities.** What you are trying to achieve this week, one line each, with a box you tick when it is done. Not tasks: outcomes. A task can serve one. **Daily highlights.** One sentence per day: the one thing that, if it happens, makes the day a win. You set it in the morning and confirm it in the evening, done or not done. Only today's row takes input; the rest of the week is what it already says. The note is plain markdown with two headings, so you can write in it by hand and the tab reads exactly what you wrote. It is created the first time you put something in it, and never before. ## Linking a task to a note A card's menu can point it at the note the work is really for, usually a project or a key element. The link lives on the planner side only, nothing is written into the note you point at, and no sync run ever changes it. ## Where your keys live One setting decides whether your keys stay on this device or follow the vault to every device you sync. The setting explains both options in plain words before you choose. Keys are held in Obsidian's own keychain, outside your notes. ## What it touches **Your vault.** Every task, event, routine and habit becomes a plain markdown note in `02 Planner/`. You can read and edit them without this plugin. **The services you connect, and only those.** With a key configured it talks to Todoist, ClickUp, your own IMAP host, the iCal addresses you paste, and Microsoft's sign-in if you use Outlook. Nothing passes through myICOR: your Microsoft registration is yours, and so are the tokens. **It reads by default.** It writes back only what you switched on: completing a task or clearing an email flag ("Complete on source"), and title, due date, priority and body edits ("Push edits to source"). Both are off until you turn them on. It never deletes anything at a source. Without a key for a source, that source is simply off. ## Good to know - **Desktop and mobile.** - **Proton Mail** connects through Proton Bridge, which must be running. - **Outlook** needs about ten minutes of one-time setup in your own Microsoft account; there is a step-by-step guide in `docs/`. - **Beta.** In daily use in a real vault, and you will find rough edges. Questions and ideas go in the [planner channel](https://app.myicor.com/icor-for-life?channel=planner); defects go in [bug reports](https://app.myicor.com/icor-for-life?channel=bug-reports). ## Support What myICOR supports: the plugin as published in a tagged release, on the current version, installed from that release. Bugs go to this repo's issues, security reports to the process in `SECURITY.md`. What the community maintains: anything marked community-maintained, including community source adapters. We review it before it is merged. We do not support it, we cannot promise it keeps working, and it can be disabled or removed in any release. What is yours: your own changes, your fork, your local patch. Please reproduce the problem on a clean install of the current release before reporting it. ## Licence MIT, see `LICENSE`. Install it, run it, read it, change it, sell it, ship it in your own product; keep the copyright and licence notice. Releases before 0.16.0 stay under the ICOR for Life Source-Available License (Code) v1.0 they were published with. The licence covers the code only. "ICOR", "ICOR for Life", "myICOR" and "Paperless Movement" are trademarks of Paperless Movement, S.L.; a fork needs its own plugin id and name. See `TRADEMARK.md`. Contributions are welcome as pull requests under the same MIT terms, with a DCO sign-off on every commit. See `CONTRIBUTING.md`. Bundled third-party components keep their own licences; see `THIRD-PARTY-NOTICES.md`.