The Terminal plugin for Obsidian integrates powerful terminal functionality directly into your notes. It allows you to run external or integrated terminals, manage multiple terminal profiles, and provides an emulated developer console that works across all platforms. Features include terminal history saving, keyboard shortcuts for quick access, and the ability to customize terminal appearance. Users can also find text in the terminal, clear the terminal, and restart it. The plugin supports shell and terminal emulator profiles and offers various commands for a seamless terminal experience within Obsidian.
- theFoxCostReviewed on Dec 26th, 2025★★★★★ahh that let me use the AI cli tool directly
3.23.0
Minor Changes
- b66f9d4: Document and require Python 3.9 or above; use 3.9 for development (macOS ships 3.9 by default).
- Update README badge and install instructions to state Python 3.9 or above.
- Lower minimum Python version in plugin requirements (magic.ts) from 3.10 to 3.9 so
the settings UI and checks reflect the same minimum. - Use Python 3.9 for development:
.python-version, PyrightpythonVersionin
pyproject.toml; runtime andrequires-pythonremain 3.9 or above. - Add Python version sync notes in AGENTS.md and comments in pyproject.toml.
Patch Changes
e023673: Complete macOS Option key handling and migrate to public xterm.js API.
- Add Option+Arrow word navigation
- Add Option+Backspace/Delete word deletion
- Replace internal
_core.coreService.triggerDataEvent()with publicterminal.input() - Fix Shift+Enter regression caused by
attachCustomKeyEventHandlerconflict - Consolidate all custom key handlers into
MacOSOptionKeyPassthroughAddon
58bda3d: Use Python 3.9-compatible type annotations in unix_pseudoterminal.py.
Commit ab83e53 introduced
from typing import Self(Python 3.11) and
type[X] | None(Python 3.10) in a refactor. The plugin runs on the user's
system Python, which on macOS defaults to 3.9.6 (Command Line Tools).
Both Python 3.9 and 3.10 crash with ImportError at startup.Replace with
from __future__ import annotationsand forward-reference
class name. Three lines changed, zero behavioral impact.3785050: Rename
MacOSOptionKeyPassthroughAddontoCustomKeyEventHandlerAddon.The addon handles multiple custom key behaviors (macOS Option key passthrough,
Shift+Enter, Option+Arrow/Backspace/Delete); the new name reflects its role as
the single custom key event handler addon. The addon slot is renamed from
macOptionKeyPassthroughtocustomKeyEventHandler. ThemacOSOptionKeyPassthrough
setting (and its behavior) is unchanged.