README file from
GithubICOR for Life - Connect
Your app.myicor.com account, inside your vault. Connect once on the desktop and your ICOR Journey, your Growth Assignments, your courses and the Inner Circle knowledge base sit next to your notes on every device your vault syncs to, instead of behind a browser tab.
Beta release. This plugin works and is in daily use in a real vault, but you will find rough edges. If something looks off, open an issue on this repo and it gets fixed fast.
What it does
- The ICOR Journey dashboard. A myICOR button sits at the bottom of the file explorer; the dot next to it shows connection state. It opens a dashboard view: ICOR Journey stage and milestones drawn on the Loop, Growth Assignment progress and average score, reflections, streaks, and per-category rollups. All colors ride INKLINE theme tokens, so light and dark both work with zero plugin palette.
- Knowledge-base search and courses. A search bar over the whole Inner Circle knowledge base (lessons, resources, founder answers); every hit deep-links into the app. A Courses card shows per-course progress; expanding a course loads the lesson list with per-lesson completion, each lesson clickable. Deep links honor the vault's Web Viewer preference: in-app when the core plugin is on, system browser when it is off.
- Room dashboards. A gauge button on each room in the file tree opens that room's dashboard: the Scratchpad, the Inbox, WiP, the Inner World, Assets and the AI Team, each with the counts and recent files that answer "what is going on in this room". Every number is computed from your own files, so these work with no myICOR connection at all.
- The team roster. The AI Team dashboard lists who is on your team and what each of them does, read from their own contracts, alongside open tasks, tasks in progress, what was finished this month, recent session logs, and the journals the team wrote as it worked.
- Reflection sync. The ICOR Journey Notes card (and the command "Sync
myICOR reflections into Inner World") pulls your growth assignment
reflections into
04 Inner World/ICOR Journey Notes/, one note per reflection, answer verbatim, with structured frontmatter. CREATE-ONLY: a synced note is never touched again, so you can edit and wikilink it freely. - Claude context. On connect, the plugin registers the myICOR MCP
server in the vault-root
.mcp.json(URL only, never a token). Claude sessions running inside this vault can then search myICOR lessons, resources, founder answers, and session recordings. The first Claude session approves the server once via/mcp. - Browser OAuth. If the vault is not connected, the plugin opens the
default browser for login and consent (OAuth 2.1 + PKCE against the
official myICOR MCP server,
https://app.myicor.com/api/mcp). The callback lands on a temporary local loopback server; nothing listens after the flow finishes.
What makes it different
Most companion plugins mirror an app inside a pane. Connect moves the parts of your membership that belong in a PKM into the PKM itself: your reflections become real markdown notes you own and can link, the knowledge base answers from inside the vault, and the Claude sessions running in this vault learn your myICOR context. One desktop connect, and it follows the vault everywhere.
Account, membership and network use (disclosure)
- An account is required for the myICOR features: the Journey dashboard, search, courses, reflection sync and Claude context all require a myICOR account at app.myicor.com.
- A free myICOR account unlocks the core features: connect, knowledge-base search, and the dashboards where your data exists. Access to gated Inner Circle content requires a paid myICOR membership.
- The room dashboards and the team roster read your vault only, and work whether you are connected or not.
- Network use: the plugin talks to exactly one service, app.myicor.com (OAuth 2.1 + PKCE sign-in and the myICOR MCP API at https://app.myicor.com/api/mcp), to read your ICOR Journey, Growth Assignments, courses, knowledge-base search results and reflections. No telemetry, no other endpoints. When not connected, the plugin makes no network requests.
Security
- Tokens live only in this plugin's
data.json. Two independent guards keep it out of git: the line in the repo's.gitignore, and the plugin itself re-asserting that line on every load before a token can ever be saved. .mcp.jsonreceives the server URL only. Claude runs its own OAuth.- Access tokens expire after 15 minutes; the plugin refreshes silently with rotating refresh tokens. Disconnect drops all tokens on the spot.
No build step
main.js is hand-written, dependency-free JavaScript: the plugin is plain
text on disk, reviewable by anyone, buildable by no one.
Install
Requires Obsidian 1.4.0 or newer.
- From Obsidian: Settings, Community plugins, Browse, search "myICOR Connect", install, enable.
- Manually: copy
main.js,manifest.jsonandstyles.cssfrom the latest release into.obsidian/plugins/icor-for-life-connect/and enable the plugin.
Then click the myICOR button at the bottom of the file explorer to connect.
On mobile
The dashboards, search and courses work on phone and tablet. The one-time OAuth connect needs the desktop app (the browser callback lands on a local loopback server); once connected there, the connection syncs to every device with the vault.
ICOR for Life Obsidian Edition
ICOR for Life - Connect is the bridge of the ICOR for Life Obsidian Edition: ICOR (Input, Control, Output, Refine), the productivity methodology by Paperless Movement / myICOR, implemented as a ready-to-use Obsidian vault. The vault is where you run the method; the courses on myicor.com are where you learn it; Connect is where the two meet. Best to be used in combination with:
- ICOR for Life - INKLINE theme, the hand-drawn ICOR look every surface of the Edition is designed against. The Connect dashboards have no palette of their own; with INKLINE installed their cards render hand-drawn in ink and paper mode alike.
- ICOR for Life - Planner, the weekly planning board: Todoist, ClickUp, starred email and Google Calendar synced into the vault, planned by drag and drop. The ICOR Journey teaches the weekly practice; the Planner is where you run it, week after week.
- ICOR for Life - Focus, the gravity map of your vault: what you touched today sits close, older work ripples outward. The Journey builds the habits; Focus shows whether they are holding.
- ICOR for Life - Diagrams, a fullscreen viewer with zoom and pan for the mermaid diagrams in your notes, including the ones the lessons ask you to draw.
- ICOR for Life - Chat, your AI team in a tab beside your notes, working from your vault's own instructions. The Journey teaches the method; the team helps you apply it to the notes in front of you.
The complete, preconfigured experience (theme, all plugins, the seven-room vault structure and the AI team) ships free as the ICOR for Life vault: https://myicor.com
License
Please note that while the source can be read and modified for your
personal use, this plugin is not open source. It is licensed under the
ICOR for Life Source-Available License (Code) - see the LICENSE file
for the full terms. Third-party notices live in THIRD-PARTY-NOTICES.md.