No description
  • TypeScript 90.6%
  • JavaScript 6.5%
  • CSS 2.9%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Boot750 4fa2891700 feat: convert empty leaves in the terminal tab group to terminals
When the user clicks Obsidian's + on a tab bar that hosts a terminal leaf,
Obsidian creates an "empty" view (the default new-tab placeholder). Listen
for layout-change and convert any empty leaf whose parent tab group
contains a terminal into a terminal-manager-view — which then renders the
shell picker. So + means "new terminal" inside the terminal tab group.

Empty leaves in other tab groups (e.g. a + on the main editor area) are
left alone.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-22 18:06:34 +08:00
.idea Add design spec for Obsidian Terminal Manager plugin 2026-05-21 01:58:15 +08:00
docs/superpowers Add implementation plan for Obsidian Terminal Manager 2026-05-21 02:05:21 +08:00
scripts fix: bundle xterm.css into styles.css so helper textarea hides properly 2026-05-22 17:07:48 +08:00
src feat: convert empty leaves in the terminal tab group to terminals 2026-05-22 18:06:34 +08:00
tests refactor: one terminal per Obsidian leaf, picker UI for empty leaves 2026-05-22 17:57:20 +08:00
.DS_Store Add design spec for Obsidian Terminal Manager plugin 2026-05-21 01:58:15 +08:00
.gitignore chore: untrack .claude/ (local Claude Code permission cache) 2026-05-22 18:03:16 +08:00
esbuild.config.mjs refactor: drop node-pty, use child_process — no native module, no build tools 2026-05-21 23:06:16 +08:00
manifest.json chore: scaffold Obsidian plugin build (esbuild, vitest, manifest) 2026-05-21 02:09:36 +08:00
package-lock.json refactor: one terminal per Obsidian leaf, picker UI for empty leaves 2026-05-22 17:57:20 +08:00
package.json refactor: drop node-pty, use child_process — no native module, no build tools 2026-05-21 23:06:16 +08:00
README.md refactor: drop node-pty, use child_process — no native module, no build tools 2026-05-21 23:06:16 +08:00
styles.css refactor: one terminal per Obsidian leaf, picker UI for empty leaves 2026-05-22 17:57:20 +08:00
tsconfig.json chore: scaffold Obsidian plugin build (esbuild, vitest, manifest) 2026-05-21 02:09:36 +08:00
vitest.config.ts chore: scaffold Obsidian plugin build (esbuild, vitest, manifest) 2026-05-21 02:09:36 +08:00

Obsidian Terminal Manager

Pre-configure terminal profiles that auto-open as tabs when a vault opens. Inspired by the JetBrains Terminal Manager plugin.

Features

  • Per-vault terminal profiles: name, shell, working directory, environment variables.
  • Auto-start selected profiles when the vault loads.
  • Tab persistence — re-spawns tabs that were open at last close.
  • Shell auto-detection (PowerShell, pwsh, cmd, Git Bash, bash, zsh, fish, …) with custom path fallback.
  • Command palette and ribbon icon to launch any profile on demand.

Install (manual, until released to community store)

  1. Clone this repository.
  2. npm install
  3. npm run package
  4. Copy dist/obsidian-terminal-manager/ into <vault>/.obsidian/plugins/.
  5. In Obsidian: Settings → Community plugins → enable "Terminal Manager".

npm run package produces a three-file plugin folder (main.js, manifest.json, styles.css) under dist/. No native modules, no Electron version pinning, no build tools required.

Configure profiles

Settings → Terminal Manager → "+ Add profile". Set name, shell, cwd (${vaultPath} substitutes to the vault root), env vars, and the autoStart flag.

Limitations

  • Desktop only — requires Node.js access for spawning shells.
  • No real PTY: programs that need a TTY (vim, htop, fzf, interactive REPLs with custom keybindings) won't work. On Windows, cmd and powershell won't render their interactive prompts (commands still execute and produce output).
  • The bottom panel is currently static; making it draggable/floating is a planned v1.x enhancement.
  • Tab persistence re-spawns processes; it does not preserve scrollback or in-flight commands.

Development

npm run dev        # watch build
npm test           # unit tests
npm run build      # production build → main.js at repo root
npm run package    # full distribution → dist/<plugin-id>/ ready for a vault

See tests/MANUAL_SMOKE.md for the manual verification checklist before shipping.