oterm

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)

1. Install BRAT from Community Plugins
2. Open BRAT settings, click "Add Beta Plugin"
3. Enter: mgriffen/oterm
4. Enable oterm in Community Plugins

Manual

1. Download main.js, manifest.json, and styles.css from the latest release
2. Create <vault>/.obsidian/plugins/oterm/ and place the files there
3. 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:

1. Go to the latest release
2. Download node-pty-<platform>.zip for your platform
3. Extract to <vault>/.obsidian/plugins/oterm/native/<platform>/

Platform values: win32-x64, darwin-arm64, darwin-x64, linux-x64, linux-arm64

Commands

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 verification
• node-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.

License

MIT