No description
- TypeScript 90.6%
- JavaScript 6.5%
- CSS 2.9%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
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> |
||
| .idea | ||
| docs/superpowers | ||
| scripts | ||
| src | ||
| tests | ||
| .DS_Store | ||
| .gitignore | ||
| esbuild.config.mjs | ||
| manifest.json | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| styles.css | ||
| tsconfig.json | ||
| vitest.config.ts | ||
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)
- Clone this repository.
npm installnpm run package- Copy
dist/obsidian-terminal-manager/into<vault>/.obsidian/plugins/. - 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,
cmdandpowershellwon'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.