DATACORE TERMINAL

A native terminal emulator running directly in Obsidian

---

A full-featured, standalone terminal emulator that runs directly within Obsidian, providing native shell access to your file system.

---

Welcome to Datacore Terminal, a self-contained native terminal interface powered by ttyd and xterm.js that runs directly within Obsidian, providing full shell access to your local machine.

---

✨ Features

🛡️ Full-Fidelity Terminal Emulator

• 🖥️ Native Shell Session: Spawns a real user shell process (zsh, bash, etc.) running as a login shell (-l) to fully inherit your custom environment path, alias mappings, and configuration profiles (such as Homebrew, opencode, and user-defined scripts).
• 🎨 Full Xterm.js Power: Delivers complete terminal emulation features, including ANSI color palettes, rich mouse events, scrollback buffers, and standard terminal controls.
• ⌨️ Perfect Key Mappings: Supports all interactive shell shortcut bindings (like Ctrl+C for interrupts, Ctrl+D for EOF, Tab for autocompletion, and history paging).

⚙️ Self-Contained & Dynamic Architecture

• 📦 Zero System Dependencies: Bundles the precompiled ttyd binary locally under the component's bin/ directory, requiring no global installation.
• 🔄 Dynamic Port Assignment: Requests a random free port (-p 0) from the OS to launch the local websocket server, avoiding conflicts with other local dev servers.
• 🔒 Secure Port Bindings: Binds strictly to the local loopback interface (127.0.0.1), ensuring access is isolated to your local device.
• 🧹 Graceful Cleanup: Standard Unix process group termination (process.kill(-pid)) runs on component unmount, ensuring the terminal server and all spawned subprocesses clean up instantly when the note pane is closed.

---

📦 Directory Index & Components

The package exposes the following compiled files:

File	Description
DATACORE TERMINAL.md	The main entry point leaf designed to be loaded inside Obsidian panes.
src/index.jsx	Main bootstrap application loader that resolves and wires the underlying views.
src/App.jsx	Core Process Manager Component handling terminal state and child processes.
METADATA.md	Packaging manifest outlining indexing, target, and security configurations.
CONTRIBUTION.md	Contributor architecture standards and local compilation guidelines.
LICENSE.md	MIT open-source license.