README file from
GithubJump to Terminal
An Obsidian plugin that opens a system terminal at the directory of the current note — via right-click or the command palette.
Features
- Command palette: run
Open terminal herefrom Ctrl/Cmd+P - Right-click in file explorer: context menu item on any file or folder
- Right-click in editor: context menu item inside the note body
- Cross-platform: macOS, Linux, and Windows with popular terminal apps pre-configured
- Custom terminal: enter any command with
{dir}as the directory placeholder
Installation
From Obsidian Community Plugins (recommended)
- Open Settings → Community plugins
- Search for "Jump to Terminal"
- Click Install, then Enable
Manual
- Download
main.jsandmanifest.jsonfrom the latest release - Copy both files into
<vault>/.obsidian/plugins/jump-to-terminal/ - Reload Obsidian and enable the plugin in Settings → Community plugins
Configuration
Open Settings → Jump to Terminal to choose your preferred terminal per platform.
| Platform | Supported terminals |
|---|---|
| macOS | Terminal, iTerm2, Warp, Alacritty, kitty, Custom |
| Linux | GNOME Terminal, Konsole, Xfce Terminal, Alacritty, kitty, xterm, Custom |
| Windows | Windows Terminal, Command Prompt, PowerShell, PowerShell (legacy), Custom |
For Custom, enter any shell command using {dir} as the placeholder:
myterm --workdir={dir}
Development
git clone https://github.com/maropark/obsidian-jump-to-terminal
cd obsidian-jump-to-terminal
npm install
# Watch mode (rebuilds on save)
npm run dev
# Production build
npm run build
Symlink into your vault for live testing:
ln -sf ~/Projects/obsidian-jump-to-terminal \
~/path/to/vault/.obsidian/plugins/jump-to-terminal
Then enable the plugin in Obsidian and use Ctrl+P → "Reload app without saving" after changes.
License
MIT