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.json receives 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.json and styles.css from 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.