ICOR for Life - Terminal

A real terminal, in the pane next to your notes.

Your login shell in a tab or a split, and a one-command start for Claude Code already pointed at your vault.

Part of the ICOR for Life suite.

Read this before installing

A terminal is the largest capability a plugin can have. Nothing here should surprise you later, so it is stated first rather than buried:

• It runs programs on your machine, as you, with your permissions. Your login shell by default, or a command you set up, or claude.
• It reaches files outside your vault, because a shell does. Whatever you can open, it can open.
• It makes no network connection of its own. No telemetry, no update check. Whatever you run inside the shell is yours.
• It touches the clipboard only when you press the key. Copy and paste work as you expect. One optional setting, off by default, copies a selection as you make it.

If any of that is more than you want in your vault, do not install it. That is a reasonable decision and the plugin will not try to talk you out of it.

What it is for

Work that lives in the vault often needs a command run against the vault: a script, a git status, an AI session in the right folder. Switching to a separate terminal app means finding the right window and typing the right cd, every time.

Here the terminal is a pane like any other. It sits in Obsidian's tabs and splits, you rename it from its tab, and it comes back in the same folder after a reload.

Getting started

Open a terminal from the command palette. It starts in your vault folder.

The Claude Code launcher starts a session already in the right place, so you never start one against the wrong folder.

Good to know

• Desktop only, macOS and Linux. There is no terminal pane on Windows in this version.
• The command palette still works while the terminal has your keyboard, so you are never trapped in the pane.
• The shell belongs to Obsidian's window. Reloading, updating or quitting Obsidian ends it, the way closing a terminal window ends the shell inside it. Closing the lid does not, on its own; what you usually see after a sleep is Obsidian reloading on wake. The pane comes back and starts a fresh shell in the same folder, without the earlier output. For a job that has to survive that, start tmux or screen in the pane and run it there.
• INKLINE skins it, and it stays legible on any other theme.
• Beta. It runs in a real vault every day and it has rough edges. If something looks off, open an issue.

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.2.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.