oterm
mgriffen552 downloadsFull terminal emulator powered by xterm.js and node-pty. Supports PowerShell, WSL, zsh, tmux, and CLI tools.
- Overview
- Scorecard
- Updates4
Full terminal emulator for Obsidian. Powered by the same technology as VS Code's terminal (xterm.js + node-pty).
Supports PowerShell, WSL, zsh, oh-my-zsh, tmux, powerlevel10k, and all rich CLI tools — including Claude Code.
Features
- Full terminal emulation — xterm.js v6 with WebGL rendering, truecolor, Unicode 11
- Multiple tabs — create, switch, close, rename (double-click) terminal sessions
- Cross-platform — Windows (PowerShell, Git Bash, WSL), macOS (zsh, bash), Linux (zsh, bash)
- Shell presets — auto-detects available shells, categorized dropdown in settings
- Find in terminal — search through terminal output with next/previous navigation
- Sidebar integration — docks in the right sidebar with a persistent icon
- Clickable links — URLs in terminal output are clickable
- Catppuccin Mocha theme — dark theme that integrates with Obsidian's UI
Installation
BRAT (recommended for beta)
- Install BRAT from Community Plugins
- Open BRAT settings, click "Add Beta Plugin"
- Enter:
mgriffen/oterm - Enable oterm in Community Plugins
Manual
- Download
main.js,manifest.json, andstyles.cssfrom the latest release - Create
<vault>/.obsidian/plugins/oterm/and place the files there - Enable oterm in Community Plugins
First Launch
When you first open a terminal, oterm downloads a platform-specific native binary (~20-400 KB) from GitHub Releases. This is a one-time download — subsequent opens use the cached binary.
If you're behind a corporate proxy or firewall, you can download the binary manually:
- Go to the latest release
- Download
node-pty-<platform>.zipfor your platform - Extract to
<vault>/.obsidian/plugins/oterm/native/<platform>/
Platform values: win32-x64, darwin-arm64, darwin-x64, linux-x64, linux-arm64
Commands
| Command | Description |
|---|---|
| Open terminal | Open or reveal the terminal panel |
| New terminal tab | Create a new terminal session |
| Next terminal tab | Switch to the next tab |
| Previous terminal tab | Switch to the previous tab |
| Close terminal tab | Close the active session (warns if processes running) |
| Find in terminal | Toggle the search bar |
Settings
- Shell — choose from detected shells (PowerShell, WSL, Git Bash, zsh, bash, fish) or AI tools (Claude Code, Aider)
- Font family — default: MesloLGS NF, Consolas, Courier New
- Font size — default: 14
- Cursor style — block, underline, or bar
- WebGL rendering — hardware-accelerated rendering (disable if you see visual artifacts)
Network Disclosure
This plugin makes network requests to GitHub (github.com and objects.githubusercontent.com) to download prebuilt native binaries on first terminal open. Specifically:
checksums.json— SHA256 hashes for integrity verificationnode-pty-<platform>.zip— platform-specific native terminal binary
No telemetry, analytics, or other network requests are made. All downloads are over HTTPS with checksum verification.
Desktop Only
This plugin requires Node.js APIs (node-pty) and only works on desktop platforms (Windows, macOS, Linux). It will not load on mobile.